recall

<help_check>

Help Check

If $ARGUMENTS contains --help or -h:

Output this help and HALT (do not proceed further):

<help_output>

RECALL(1)                                            User Commands                                            RECALL(1)

NAME
    recall - Recall relevant memories for the current context or a s...

SYNOPSIS
    /memory:recall [query] [--namespace=ns] [--limit=n]

DESCRIPTION
    Recall relevant memories for the current context or a specific query

OPTIONS
    --help, -h                Show this help message

EXAMPLES
    /memory:recall
    /memory:recall <query>
    /memory:recall --help

SEE ALSO
    /memory:* for related commands

                                                                      RECALL(1)

</help_output>

After outputting help, HALT immediately. Do not proceed with command execution. </help_check>

---

/memory:recall - Recall Relevant Memories

Retrieve relevant memories from the git-backed memory system.

Your Task

You will help the user recall memories relevant to their current context or query.

Arguments format: $ARGUMENTS

Parse the arguments:

1. Extract --namespace=<ns> if present (one of: decisions, learnings, blockers, progress, reviews, patterns, retrospective, inception, elicitation, research)
2. Extract --limit=<n> if present (default: 5)
3. Everything else is the search query
4. If no query provided, use recent conversation context

If query is empty:

• Extract key concepts from recent conversation (last 5-10 messages)
• Look for: file names, function names, error messages, technology terms
• Combine into a search query

Use Bash to invoke the Python library:

PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
uv run --directory "$PLUGIN_ROOT" python3 -c "
from git_notes_memory import get_recall_service

recall = get_recall_service()
results = recall.search(
    query='''$QUERY''',
    namespace=$NAMESPACE,  # None for all namespaces
    k=$LIMIT,
)

if not results:
    print('No relevant memories found.')
else:
    print(f'## Recalled Memories ({len(results)} results)\n')
    for i, r in enumerate(results, 1):
        # Use summary (not title) and timestamp (not created_at)
        print(f'### {i}. {r.namespace.title()}: {r.summary[:50]}')
        print(f'**Relevance**: {r.score:.2f} | **Captured**: {r.timestamp.strftime(\"%Y-%m-%d\")}')
        print(f'> {r.content[:200]}...\n')
"