recall
Performs full-text search with BM25 ranking to retrieve all past Claude Code and Codex session records, helping users quickly review and find historical information.
npx skills add arjunkmrm/recall --skill recallBefore / After Comparison
1 组Without the `recall` skill, users often have to manually sift through large amounts of historical records or search their memory when needing to review or reuse information from previous Claude or Codex sessions. This is not only time-consuming and laborious but also easily leads to missing key information, resulting in repetitive questions or starting over.
With the `recall` skill, users can perform full-text searches across all historical Claude and Codex conversations using keywords or phrases. The system can quickly locate relevant conversation snippets, helping users reuse previous context, code, or solutions, significantly improving information retrieval efficiency and work continuity.
description SKILL.md
recall
/recall — Search Past Claude & Codex Sessions
Search all past Claude Code and Codex sessions using full-text search with BM25 ranking.
Usage
python3 ~/.claude/skills/recall/scripts/recall.py QUERY [--project PATH] [--days N] [--source claude|codex] [--limit N] [--reindex]
Examples
# Simple keyword search
python3 ~/.claude/skills/recall/scripts/recall.py "bufferStore"
# Phrase search (exact match)
python3 ~/.claude/skills/recall/scripts/recall.py '"ACP protocol"'
# Boolean query
python3 ~/.claude/skills/recall/scripts/recall.py "rust AND async"
# Prefix search
python3 ~/.claude/skills/recall/scripts/recall.py "buffer*"
# Filter by project and recency
python3 ~/.claude/skills/recall/scripts/recall.py "state machine" --project ~/my-project --days 7
# Search only Claude Code sessions
python3 ~/.claude/skills/recall/scripts/recall.py "buffer" --source claude
# Search only Codex sessions
python3 ~/.claude/skills/recall/scripts/recall.py "buffer" --source codex
# Force reindex
python3 ~/.claude/skills/recall/scripts/recall.py --reindex "test"
Query Syntax (FTS5)
-
Words:
bufferStore— matches stemmed variants (e.g., "discussing" matches "discuss") -
Phrases:
"ACP protocol"— exact phrase match -
Boolean:
rust AND async,tauri OR electron,NOT deprecated -
Prefix:
buffer*— matches bufferStore, bufferMap, etc. -
Combined:
"state machine" AND test
After Finding a Match
To resume a session, cd into the project directory and use the appropriate command:
# Claude Code sessions [claude]
cd /path/to/project
claude --resume SESSION_ID
# Codex sessions [codex]
cd /path/to/project
codex resume SESSION_ID
Each result includes a File: path. Use it to read the raw transcript (auto-detects format):
python3 ~/.claude/skills/recall/scripts/read_session.py <File-path-from-result>
If results are missing File: paths, run --reindex to backfill.
Notes
-
Index is stored at
~/.recall.db(SQLite FTS5, auto-migrated from~/.claude/recall.db) -
Indexes both
~/.claude/projects/(Claude Code) and~/.codex/sessions/(Codex) -
First run indexes all sessions (a few seconds); subsequent runs are incremental
-
Only user and assistant messages are indexed (tool calls, thinking blocks, state snapshots skipped)
-
Results show
[claude]or[codex]tags to indicate the source
Weekly Installs305Repositoryarjunkmrm/recallGitHub Stars111First SeenMar 3, 2026Security AuditsGen Agent Trust HubPassSocketPassSnykPassInstalled oncodex298gemini-cli293kimi-cli292amp292cline292github-copilot292
forumUser Reviews (0)
Write a Review
No reviews yet
Statistics
User Rating
Rate this Skill