Recall CLI
Local search across all coding agent sessions with a return to the original CLI and token usage stats.
- 109 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The tool reads all local agent session histories, which may contain secrets.
- The share command publishes a session at a public link.
Install
- Works in
Manual install
brew install samzong/tap/recallThe command from the Install section. Then `recall sync` and `recall skill install`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The tool reads all local agent session histories, which may contain secrets.
- The share command publishes a session at a public link.
This is third-party code. Review the repository files before installing.
What it does
Recall gathers scattered sessions of Claude Code, Codex, OpenCode, Pi, Gemini and other agents into one local index. Search works on text and meaning (local embeddings), results open in a terminal UI, and the chosen session resumes in its original CLI. `recall usage` shows a token usage dashboard where the agent records it. There is JSONL export and import, `recall session list` for scripts and agents, and publishing a single session by link. The skill installs with `recall skill install`, which detects installed agents and adds a skill so the agent can search past sessions.
Who it is for. Developers who switch between several coding agents and lose the conversation they need among dozens of scattered histories.
Good fit when
- A decision was made in a month-old session and you need its wording.
- The same task was handled in Claude Code and Codex and you need one search.
- You want to see how many tokens went to projects and agents.
- The agent should search past sessions itself through an installed skill.
Not a fit when
- You need a cloud index across machines: Recall is local.
- Agent history is disabled or deleted.
- You need precise cost accounting: figures come from agent metadata and may be incomplete.
Example request
Find the database migration discussion in my past sessions and show which agent and when it happened.Limitations
Recall reads local session files and builds the index on your machine, so completeness depends on where and how each agent stores history. Token usage data does not exist for every agent: in the support table some adapters lack the Usage column. `recall session share` publishes a chosen session at a public link, revoked with `recall share unpublish`, so review the content before publishing. The Homebrew install targets macOS and Linux, and other systems need builds from the releases page.
How to disable. Remove the package (`brew uninstall recall`) and the index directory. Remove the skill from the agents' skill directories.
FAQ
Which agents are supported?
Claude Code, OpenCode, Codex, Pi, OMP, rx-agent, Antigravity, Gemini and others. Each has discovery, indexing, search, export and resume; token stats are not available for all.
How do I find a session by meaning?
Recall builds a vector index with the local `multilingual-e5-small` model, so search finds related fragments without the exact word.
What does `recall sync` do?
It incrementally updates the index for the current project. With `--project all` it processes every project.
How do I move history to another machine?
`recall export --project all > recall-export.jsonl`, then `recall import recall-export.jsonl --dry-run` to preview before loading.
How do I share a session?
`recall session share --id <id> --format json` publishes a page. Revoke it with `recall share unpublish <share-id> --yes`.
Discussion
No questions or reviews yet.
Related
CLI toolsA skill for searching past sessions: a full-text index of Claude Code, Codex, pi and Grok chats in one SQLite database
Local browsing, search and cost tracking for Claude Code, Codex and other agent sessions in one web UI
Terminal search across Claude Code, Codex, OpenCode and other agent sessions, with a jump back into the right chat
An fzf-based CLI that lists sessions of Claude Code, Codex and six more agents across projects and resumes the chosen one.
Token and cost reports for Claude Code, Codex, Gemini CLI and other agents from local logs, by day, month and session
A CLI that hands session context between coding agents: continue a Claude Code session in Codex, Cursor, OpenCode and others.
README in short
Shows the architecture, Homebrew install, main commands, the agent support table and a skill for the agents themselves.