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
.claude/commands/instinct-export.mdWhat 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.mdCall it with /instinct-export. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/instinct-export.mdCall it with /prompts:instinct-export. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/instinct-export.prompt.mdManually: put the files in place
.gemini/commands/instinct-export.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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