brain-merge

Brain Merge

Compare and selectively merge knowledge between any two Brain directories. Works across any agent instances - not tied to specific paths.

Purpose

Agent brains develop independently and accumulate unique insights. This playbook lets you see what each brain has that the other doesn't, and move knowledge between them safely.

Modes

• diff - Compare two brains, see what's unique to each
• pull - Import files from a source brain into a target brain
• learn - Bidirectional exchange with approval at each direction

State Dependencies

Source	Location	Read	Write
Source brain	User-specified path	✓	-
Target brain	User-specified path (defaults to current)	✓	✓
FAISS index	[agent-root]/resources/local-brain-search/data/	-	✓

Process

Step 0: Resolve inputs

Ask the user for:

1. Source brain path - the brain to compare against or pull from
2. Target brain path - the brain to compare or import into (default: current agent's ./Brain)
3. Mode - diff, pull, or learn (infer from user's message if obvious)

If paths are ambiguous (user says "moltbook" or "the other one"), scan parent directories for Brain/ folders and present a pick list:

find . -maxdepth 3 -name "Brain" -type d 2>/dev/null | sort

---

DIFF MODE

Goal: Show what each brain has that the other doesn't, grouped by folder.

Step 1: Inventory both brains

SOURCE="[SOURCE_BRAIN_PATH]"
TARGET="[TARGET_BRAIN_PATH]"

find "$SOURCE" -name "*.md" | sed "s|$SOURCE/||" | sort > /tmp/brain_source.txt
find "$TARGET" -name "*.md" | sed "s|$TARGET/||" | sort > /tmp/brain_target.txt

echo "Source: $(wc -l < /tmp/brain_source.txt) files"
echo "Target: $(wc -l < /tmp/brain_target.txt) files"

Step 2: Generate diff lists

comm -23 /tmp/brain_source.txt /tmp/brain_target.txt > /tmp/unique_to_source.txt
comm -13 /tmp/brain_source.txt /tmp/brain_target.txt > /tmp/unique_to_target.txt
comm -12 /tmp/brain_source.txt /tmp/brain_target.txt > /tmp/in_both.txt

echo "Unique to source: $(wc -l < /tmp/unique_to_source.txt)"
echo "Unique to target: $(wc -l < /tmp/unique_to_target.txt)"
echo "In both: $(wc -l < /tmp/in_both.txt)"