| name | memory-search |
| description | Search memory files for keywords, patterns, or categories. Returns structured results grouped by file with context. |
Memory Search
Search across memory files for keywords, patterns, or past decisions. Returns structured results grouped by file with line numbers and category tags.
Usage
Parse the user's invocation to extract the query and any flags:
/memory-search <query>
/memory-search --global <query>
/memory-search --sessions <query>
/memory-search --category <name> <query>
/memory-search --cross-project <query>
/memory-search --cross-project --category <name> <query>
Flags can appear in any order relative to the query.
Execution
Run the search script via Bash:
bash "<conkeeper-path>/tools/memory-search.sh" <parsed-args>
Where <conkeeper-path> is the ConKeeper installation directory (typically found via git rev-parse --show-toplevel or the directory containing the tools/ folder).
Pass the query and any flags (--global, --sessions, --category <name>) directly to the script.
Presenting Results
- Display the script output to the user as-is (it is already Markdown-formatted)
- If results are found, briefly note how many matches and files were returned
- If the query was filtered by
--category, mention which category was used
No Results
If the script returns "No results found", suggest broadening the search:
- Try
--global — include global memory (~/.claude/memory/)
- Try
--sessions — include session history files (last 30 days)
- Try alternate keywords — suggest synonyms or related terms based on the query
- Remove
--category — if category filtering was used, try without it
Examples
/memory-search "token budget"
/memory-search --global "naming convention"
/memory-search --sessions "authentication bug"
/memory-search --category decision "database"
/memory-search --category pattern --global "error handling"
/memory-search --cross-project "authentication"
/memory-search --cross-project --category decision "database"
