Imports instincts from an export file into inherited/ directory after confirmation, prefixing filenames to avoid conflicts and updating identity counts.
From homunculusnpx claudepluginhub humanplane/homunculus --plugin homunculus/importDisplays migration notice for removed JSONL issue import command, instructing use of bd init --from-jsonl flag with Dolt backend.
/importImports CSV, JSON, JSONL, or PDF files into a Weaviate collection with mapping, field skipping, multi-tenancy, and batching options.
/importImports memories from Codex CLI (AGENTS.md), Cursor (.cursor/rules/), and Windsurf (.windsurfrules) into Nemp with conflict detection and guided resolution. Pro feature.
/importImports external markdown files or folders into Obsidian vault, automatically adding frontmatter with title, description, tags, and dates if missing.
/importImports document from file path (MD/TXT/PDF) or pasted text, extracts/maps content to PR/FAQ sections, launches /prfaq workflow.
/importImports an external plan document, validates against project context, detects conflicts, and generates PLAN.md files.
Adopt instincts shared by others.
Imported instincts go to inherited/, not personal/.
This keeps clear separation:
personal/ = learned from YOUR behaviorinherited/ = adopted from others# User provides path to export file
IMPORT_FILE="$ARGUMENTS"
if [ ! -f "$IMPORT_FILE" ]; then
echo "File not found: $IMPORT_FILE"
exit 1
fi
# Extract to temp directory first
TEMP_DIR=$(mktemp -d)
tar -xzf "$IMPORT_FILE" -C "$TEMP_DIR"
# Show what we're importing
echo "=== Importing ==="
ls -la "$TEMP_DIR/personal/" 2>/dev/null
# Count
COUNT=$(ls "$TEMP_DIR/personal/" 2>/dev/null | wc -l | tr -d ' ')
echo ""
echo "Found $COUNT instincts to import."
Wait for confirmation before proceeding.
# Move to inherited (rename to avoid conflicts)
mkdir -p .claude/homunculus/instincts/inherited
for f in "$TEMP_DIR/personal/"*.md; do
if [ -f "$f" ]; then
BASENAME=$(basename "$f")
# Add prefix to avoid conflicts
DEST=".claude/homunculus/instincts/inherited/imported-$BASENAME"
cp "$f" "$DEST"
fi
done
# Cleanup
rm -rf "$TEMP_DIR"
# Count inherited
INHERITED=$(ls .claude/homunculus/instincts/inherited/ 2>/dev/null | wc -l | tr -d ' ')
echo "Imported. You now have $INHERITED inherited instincts."
# Update counts
STATE=".claude/homunculus/identity.json"
INHERITED=$(ls .claude/homunculus/instincts/inherited/ 2>/dev/null | wc -l | tr -d ' ')
jq --arg i "$INHERITED" '.instincts.inherited = ($i|tonumber)' "$STATE" > tmp.json && mv tmp.json "$STATE"
Importing [N] instincts from [FILE].
These will go to inherited/, not personal/.
You can review them anytime.
Proceed? (yes/no)
After import:
Done. [N] instincts inherited.
They'll apply alongside your personal instincts.