setup

Memory

Search first: /mnemonic:search {relevant_keywords} Capture after: /mnemonic:capture {namespace} "{title}"

Run /mnemonic:list --namespaces to see available namespaces from loaded ontologies.

/mnemonic:setup

Configure Claude to proactively use mnemonic memory without user intervention.

What This Command Does

1. Prompts user for memory store path (default: ~/.claude/mnemonic)
2. Creates ~/.config/mnemonic/config.json with user's choice
3. Detects organization from git remote
4. Detects project name from git root
5. Creates unified mnemonic directory structure under ${MNEMONIC_ROOT}/{org}/{project}/
6. Initializes git repository for versioning
7. Appends proactive behavior instructions to ~/.claude/CLAUDE.md (global only)
8. Creates initial project context memory
9. If memories exist at old path and user chose different path, auto-migrates

Arguments

• --force - Overwrite existing mnemonic configuration sections

Procedure

Step 0: Configure Memory Store Path

Ask the user where to store memories. Create the config file at the fixed XDG location.

# Check for existing config
if [ -f ~/.config/mnemonic/config.json ]; then
    STORE_PATH=$(python3 -c "import json; print(json.load(open('$HOME/.config/mnemonic/config.json'))['memory_store_path'])")
    echo "Existing config found. Memory store path: $STORE_PATH"
else
    STORE_PATH="~/.claude/mnemonic"
fi

Ask the user: "Where should mnemonic store memories? (default: ~/.claude/mnemonic)"

After the user responds (or accepts default):

# Create config directory and file
mkdir -p ~/.config/mnemonic
cat > ~/.config/mnemonic/config.json << EOF
{
  "version": "1.0",
  "memory_store_path": "$STORE_PATH"
}
EOF
echo "Config saved to ~/.config/mnemonic/config.json"

# Expand for use in subsequent steps
STORE_PATH_EXPANDED="${STORE_PATH/#\~/$HOME}"

Step 1: Detect Context

# Organization from git remote
ORG=$(git remote get-url origin 2>/dev/null | sed -E 's|.*[:/]([^/]+)/[^/]+\.git$|\1|' | sed 's|\.git$||')
[ -z "$ORG" ] && ORG="default"

# Project from git root
PROJECT=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null)
[ -z "$PROJECT" ] && PROJECT=$(basename "$PWD")

echo "Organization: $ORG"
echo "Project: $PROJECT"