---
id: sm-recall
name: "recall"
url: https://skills.yangsir.net/skill/sm-recall
author: arjunkmrm
domain: data-ai
tags: ["Information Retrieval", "Memory Systems", "AI Memory", "Contextual Recall", "Knowledge Bases"]
install_count: 2884
rating: 4.40 (115 reviews)
github: https://github.com/arjunkmrm/recall
---

# recall

> 通过BM25排名进行全文搜索，检索所有过去的Claude Code和Codex会话记录，帮助用户快速回顾和查找历史信息。

**Stats**: 2,884 installs · 4.4/5 (115 reviews)

## Before / After 对比

### 历史会话信息检索与重用效率

| Metric | Before | After | Change |
|---|---|---|---|
| - | - | - | - |
| - | - | - | - |
| - | - | - | - |

## Readme

# 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 Installs305Repository[arjunkmrm/recall](https://github.com/arjunkmrm/recall)GitHub Stars111First SeenMar 3, 2026Security Audits[Gen Agent Trust HubPass](/arjunkmrm/recall/recall/security/agent-trust-hub)[SocketPass](/arjunkmrm/recall/recall/security/socket)[SnykPass](/arjunkmrm/recall/recall/security/snyk)Installed oncodex298gemini-cli293kimi-cli292amp292cline292github-copilot292

---
*Source: https://skills.yangsir.net/skill/sm-recall*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm-recall/markdown*