recall

Name: recall
Author: arjunkmrm

Full-text search across past Claude Code and Codex sessions with BM25 ranking and flexible query syntax. Supports keyword search, exact phrases, boolean operators (AND, OR, NOT), and prefix matching across all indexed conversations Filters results by project path, recency (days), and source (Claude Code or Codex sessions) Includes session resumption commands and a transcript reader to view raw conversation files Automatically indexes user and assistant messages from ~/.claude/projects/ and ~/.codex/sessions/ ; subsequent searches are incremental

INSTALLATION

npx skills add https://github.com/arjunkmrm/recall --skill recall

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$29

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`

- **CJK**: `issue化` — automatically uses trigram matching for Japanese/Chinese/Korean text

## 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>