Skip to main content
command CX Codex

instinct-export — Claude Code command: what it does, how to install

instinct-export exports continuous-learning instincts into a shareable file for team members or migration across machines.

MIT ★ 880 updated 2026-09-03

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/instinct-export.md
Open on GitHub

What instinct-export does

The command reads stored patterns from ~/.claude/homunculus/instincts/personal/ and compiles them into a structured export. It creates a YAML file named instincts-export-YYYYMMDD.yaml by default, though JSON and Markdown are also supported via --format.

Privacy scrubbing runs automatically during export. The tool strips session IDs, full file paths, and older timestamps, leaving only trigger patterns, actions, observation tallies, and domain tags.

If ~/.claude/homunculus/instincts/personal/ does not exist or lacks instinct records, the command will find nothing to process.

What it helps with

  • share continuous-learning instincts with teammates
  • transfer personal agent patterns to a fresh machine
  • isolate testing or workflow instincts using domain filters
  • extract only high-confidence patterns above a specific score

Example prompts for the agent

  • /instinct-export
  • /instinct-export --domain testing
  • /instinct-export --min-confidence 0.7 --output team-instincts.yaml

How to install instinct-export

Manually: put the files in place

.claude/commands/instinct-export.md

Call it with /instinct-export. For all projects use ~/.claude/commands/

Questions about instinct-export

How to install instinct-export in Claude Code?

Place the command specification file into .claude/commands/instinct-export.md within your project.

What does instinct-export do?

It reads saved habits from ~/.claude/homunculus/instincts/personal/, strips private file paths and session IDs, then generates a shareable YAML, JSON, or Markdown summary.

Does instinct-export leak sensitive project code?

No, the export intentionally omits raw code snippets, personal identifiers, and concrete directory paths, keeping only general triggers and actions.

Source text

instinct-export.md · MIT
---
name: instinct-export
description: Export instincts for sharing with teammates or other projects
command: /instinct-export
---

# Instinct Export Command

Exports instincts to a shareable format. Perfect for:
- Sharing with teammates
- Transferring to a new machine
- Contributing to project conventions

## Usage

```
/instinct-export                           # Export all personal instincts
/instinct-export --domain testing          # Export only testing instincts
/instinct-export --min-confidence 0.7      # Only export high-confidence instincts
/instinct-export --output team-instincts.yaml
```

## What to Do

1. Read instincts from `~/.claude/homunculus/instincts/personal/`
2. Filter based on flags
3. Strip sensitive information:
   - Remove session IDs
   - Remove file paths (keep only patterns)
   - Remove timestamps older than "last week"
4. Generate export file

## Output Format

Creates a YAML file:

```yaml
# Instincts Export
# Generated: 2025-01-22
# Source: personal
# Count: 12 instincts

version: "2.0"
exported_by: "continuous-learning-v2"
export_date: "2025-01-22T10:30:00Z"

instincts:
  - id: prefer-functional-style
    trigger: "when writing new functions"
    action: "Use functional patterns over classes"
    confidence: 0.8
    domain: code-style
    observations: 8

  - id: test-first-workflow
    trigger: "when adding new functionality"
    action: "Write test first, then implementation"
    confidence: 0.9
    domain: testing
    observations: 12

  - id: grep-before-edit
    trigger: "when modifying code"
    action: "Search with Grep, confirm with Read, then Edit"
    confidence: 0.7
    domain: workflow
    observations: 6
```

## Privacy Considerations

Exports include:
- ✅ Trigger patterns
- ✅ Actions
- ✅ Confidence scores
- ✅ Domains
- ✅ Observation counts

Exports do NOT include:
- ❌ Actual code snippets
- ❌ File paths
- ❌ Session transcripts
- ❌ Personal identifiers

## Flags

- `--domain <name>`: Export only specified domain
- `--min-confidence <n>`: Minimum confidence threshold (default: 0.3)
- `--output <file>`: Output file path (default: instincts-export-YYYYMMDD.yaml)
- `--format <yaml|json|md>`: Output format (default: yaml)
- `--include-evidence`: Include evidence text (default: excluded)

© sangrokjung · MIT · sangrokjung/claude-forge

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set44

The whole set →
loop-forge loop-forge converts a single-line routine task into a reusable slash command equipped with safety gates and evaluation checks. CX Codex +1 ★ 880repo stars korean-spell-check korean-spell-check — a Claude Code skill that checks Korean spelling and returns edits instead of a rewritten draft. Long input gets split into chunks before it goes out. CX Codex +1 ★ 880repo stars instinct-status Review learned instincts with their confidence levels, domains, and sources. Use the command to inspect what the agent has picked up from its observations. CX Codex +1 ★ 880repo stars doc-updater doc-updater rebuilds README, guides and codemaps from the actual source after code changes. Useful once the docs have drifted away from the code. CX Codex ★ 880repo stars eval This command defines eval criteria, runs checks, and builds reports. Use it to track a feature’s capabilities and catch regressions against a baseline. CX Codex +1 ★ 880repo stars refactor-cleaner refactor-cleaner — a subagent that hunts down code nobody calls: unused files, exports and npm packages. Each hit gets a reference search before anything is deleted. CX Codex ★ 880repo stars task-grade-routing task-grade-routing sets documentation and review lane obligations for task sizes S, M, L, and XL based on workflow classification. CX Codex +1 ★ 880repo stars frontend-code-review The frontend-code-review skill checks frontend files against a checklist and formats findings in a fixed review structure. Use it for pending changes or specific files you name. CX Codex +1 ★ 880repo stars

Project sponsors

Companies that keep this analytics open