How do I install recall?

Run `npx skills add https://github.com/arjunkmrm/recall --skill recall` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does recall support?

recall works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is recall free to use?

Yes. recall is free to install and use. It is available from the open explainx.ai skill registry published by arjunkmrm.

Productivity

recall▌

Name: recall
Availability: InStock
Author: arjunkmrm

arjunkmrm/recall · updated Apr 8, 2026

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

summary

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/proj

skill.md

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

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
Dual-table FTS: English queries use Porter stemming, CJK queries use trigram matching
Upgrading from 0.2.x: run --reindex once to build the CJK index