search

<help_check>

Help Check

If $ARGUMENTS contains --help or -h:

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

<help_output>

SEARCH(1)                                            User Commands                                            SEARCH(1)

NAME
    search - Search memories with advanced filtering options

SYNOPSIS
    /memory:search <query> [--type=semantic|text] [--namespace=ns] [--limit=n]

DESCRIPTION
    Search memories with advanced filtering options

OPTIONS
    --help, -h                Show this help message

EXAMPLES
    /memory:search
    /memory:search --help

SEE ALSO
    /memory:* for related commands

                                                                      SEARCH(1)

</help_output>

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

---

/memory:search - Advanced Memory Search

Search memories with advanced filtering and search options.

Your Task

You will help the user search memories with precise control over search behavior.

Arguments format: $ARGUMENTS

Parse the arguments:

1. Extract --type=<type> if present: semantic (default) or text
2. Extract --namespace=<ns> if present
3. Extract --spec=<spec> if present
4. Extract --limit=<n> if present (default: 10)
5. Extract --verbose flag if present
6. Everything else is the search query

If query is missing, use AskUserQuestion to prompt for it.

Use Bash to invoke the Python library:

Semantic Search (default - vector similarity):

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''',
    k=$LIMIT,
    namespace=$NAMESPACE,
    spec=$SPEC,
)

print(f'## Search Results for \"{'''$QUERY'''}\" ({len(results)} found)\n')
if results:
    print('| # | Namespace | Summary | Score | Date |')
    print('|---|-----------|---------|-------|------|')
    for i, r in enumerate(results, 1):
        summary = r.summary[:40].replace('|', '\\|')
        date = r.timestamp.strftime('%Y-%m-%d')
        print(f'| {i} | {r.namespace} | {summary} | {r.score:.2f} | {date} |')
else:
    print('No results found.')
"