recall

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:recall

Search and recall memories from the mnemonic filesystem.

Arguments

• [query] - Optional search term for full-text search
• --namespace - Filter by namespace (_semantic/decisions, _semantic/knowledge, _semantic/entities, _episodic/incidents, _episodic/sessions, _episodic/blockers, _procedural/runbooks, _procedural/patterns, _procedural/migrations)
• --tags - Filter by tags (comma-separated)
• --since - Time filter (7d, 30d, 90d, 1y)
• --type - Filter by cognitive type (semantic, episodic, procedural)
• --scope - project, org, or all (default: all)
• --limit - Maximum results (default: 10)
• --full - Show full memory content instead of summary

Procedure

Step 1: Parse Arguments

QUERY="${1:-}"
NAMESPACE="${NAMESPACE:-}"
TAGS="${TAGS:-}"
SINCE="${SINCE:-}"
TYPE="${TYPE:-}"
SCOPE="${SCOPE:-all}"
LIMIT="${LIMIT:-10}"
FULL="${FULL:-false}"

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

Step 2: Build Search Paths

SEARCH_PATHS=""

# Get project name from git remote or directory
PROJECT=$(git remote get-url origin 2>/dev/null | sed -E 's|.*/([^/]+)\.git$|\1|' | sed 's|\.git$||')
[ -z "$PROJECT" ] && PROJECT=$(basename "$(pwd)")

# All memories are under ${MNEMONIC_ROOT}/
# Path structure:
#   {org}/{project}/ - project-specific memories
#   {org}/ - org-wide memories (shared across projects)
#   default/ - fallback when org detection fails
case "$SCOPE" in
    project)
        SEARCH_PATHS="$HOME/.claude/mnemonic/$ORG/$PROJECT"
        ;;
    org)
        SEARCH_PATHS="$HOME/.claude/mnemonic/$ORG"
        ;;
    all|*)
        # Search project-specific, then org-wide, then default
        SEARCH_PATHS="$HOME/.claude/mnemonic/$ORG/$PROJECT $HOME/.claude/mnemonic/$ORG $HOME/.claude/mnemonic/default"
        ;;
esac

# Narrow by namespace if specified
if [ -n "$NAMESPACE" ]; then
    NEW_PATHS=""
    for path in $SEARCH_PATHS; do
        NEW_PATHS="$NEW_PATHS $path/$NAMESPACE"
    done
    SEARCH_PATHS="$NEW_PATHS"
fi