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
CLI

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.
All reasons and checks

samzong/recall

Install

Manual install

brew install samzong/tap/recall

The command from the Install section. Then `recall sync` and `recall skill install`.

Access and checks

How we review

Extended 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.

CLI tools

A skill for searching past sessions: a full-text index of Claude Code, Codex, pi and Grok chats in one SQLite database

SkillMinimal access146Repository stars

Local browsing, search and cost tracking for Claude Code, Codex and other agent sessions in one web UI

CLIExtended access6.4KRepository stars

Terminal search across Claude Code, Codex, OpenCode and other agent sessions, with a jump back into the right chat

CLIExtended access193Repository stars

An fzf-based CLI that lists sessions of Claude Code, Codex and six more agents across projects and resumes the chosen one.

CLIExtended access51Repository stars
Editors’ pick

Token and cost reports for Claude Code, Codex, Gemini CLI and other agents from local logs, by day, month and session

CLIExtended access19.4KRepository stars

A CLI that hands session context between coding agents: continue a Claude Code session in Codex, Cursor, OpenCode and others.

CLIExtended access83Repository stars

README in short

Shows the architecture, Homebrew install, main commands, the agent support table and a skill for the agents themselves.

README badge

Report a problem