How do I install the Recall skill?

Run npx skillmds@latest add dansnow/recall in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Recall safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Recall?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Recall free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Recall?

dansnow (@dansnow) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Recall by dansnow — Agent Skill

Name: Recall
Author: dansnow

Recall

Search past Claude Code and Codex sessions. Triggers: /recall, "search old conversations", "find a past session", "recall a previous conversation", "search session history", "what did we discuss", "remember when we"

dansnow c129d18 7 files · 31.7 KB Updated Sep 17, 2026

File contents

/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

---name: recalldescription: Search past Claude Code and Codex sessions. Triggers: /recall, "search old conversations", "find a past session", "recall a previous conversation", "search session history", "what did we discuss", "remember when we"---# /recall — Search Past Claude & Codex SessionsSearch all past Claude Code and Codex sessions using full-text search with BM25 ranking.## Usage```bashpython3 ~/.claude/skills/recall/scripts/recall.py QUERY [--project PATH] [--days N] [--source claude|codex] [--limit N] [--reindex]```## Examples```bash# Simple keyword searchpython3 ~/.claude/skills/recall/scripts/recall.py "bufferStore"# Phrase search (exact match)python3 ~/.claude/skills/recall/scripts/recall.py '"ACP protocol"'# Boolean querypython3 ~/.claude/skills/recall/scripts/recall.py "rust AND async"# Prefix searchpython3 ~/.claude/skills/recall/scripts/recall.py "buffer*"# Filter by project and recencypython3 ~/.claude/skills/recall/scripts/recall.py "state machine" --project ~/my-project --days 7# Search only Claude Code sessionspython3 ~/.claude/skills/recall/scripts/recall.py "buffer" --source claude# Search only Codex sessionspython3 ~/.claude/skills/recall/scripts/recall.py "buffer" --source codex# Force reindexpython3 ~/.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 MatchTo resume a session, `cd` into the project directory and use the appropriate command:```bash# Claude Code sessions [claude]cd /path/to/projectclaude --resume SESSION_ID# Codex sessions [codex]cd /path/to/projectcodex resume SESSION_ID```Each result includes a `File:` path. Use it to read the raw transcript (auto-detects format):```bashpython3 ~/.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

Frequently asked questions