# recall

> A Go CLI that searches every past coding-agent session transcript on a machine, both Claude Code and
> Codex CLI, from any checkout of a repo, in about 30 milliseconds, with no index. It also serves
> the same four questions to an agent over the Model Context Protocol. Every answer states what it
> did *not* search, and its own token cost.

recall exists because coding agents key their session transcripts by checkout path, so one logical
repository sprawls across clones and worktrees and a path-scoped search silently misses. recall
resolves a repo by its git remote instead, making every checkout one corpus.

Seven commands: `find` (which session), `turns` (the passages), `show` (a conclusion in context),
`when` (place a topic in time), `doctor` (archive integrity), `guide` (which command to use),
`update` (replace this binary with the latest release).
Install with `curl -fsSL https://raw.githubusercontent.com/mayberuk/recall/main/install.sh | sh`;
register it with a coding agent using `recall mcp install <client>`.

## Docs

- [Everything, in one file](https://recall.mayberuk.com/llms-full.txt): this map, the whole documentation page and the full benchmark results, concatenated. Fetch this one if you only fetch one
- [Site](https://recall.mayberuk.com): the project's home page
- [Documentation](https://recall.mayberuk.com/docs.md): every command, flag, exit code and MCP tool, as markdown
- [Benchmarks](https://recall.mayberuk.com/bench.md): every published figure, as markdown, measured against a corpus generated from a fixed seed
- [README](https://raw.githubusercontent.com/mayberuk/recall/main/README.md): what it is, install, and the headline example
- [Worked examples](https://raw.githubusercontent.com/mayberuk/recall/main/docs/examples.md): real output for all six commands, reproducible via scripts/demo.sh
- [MCP integration](https://raw.githubusercontent.com/mayberuk/recall/main/docs/mcp.md): the five tools, every supported client's config path, what `install` writes
- [For calling agents](https://raw.githubusercontent.com/mayberuk/recall/main/docs/agents.md): exit codes, `--json` and `--format jsonl`, the coverage contract, choosing a provider
- [Changelog](https://raw.githubusercontent.com/mayberuk/recall/main/CHANGELOG.md): read before upgrading, because v1.1 rebuilds the archive

## Contributing

- [AGENTS.md](https://raw.githubusercontent.com/mayberuk/recall/main/AGENTS.md): build, test and style contract for an agent working on recall's source
- [CONTRIBUTING](https://raw.githubusercontent.com/mayberuk/recall/main/CONTRIBUTING.md): the five test tiers, the dependency rule, the assembly bar
- [Security policy](https://raw.githubusercontent.com/mayberuk/recall/main/SECURITY.md): how to report a vulnerability

## Optional

- [Install script](https://raw.githubusercontent.com/mayberuk/recall/main/install.sh): POSIX sh, verifies the release sha256 before installing
- [Shell integration](https://raw.githubusercontent.com/mayberuk/recall/main/shell/recall.zsh): the fzf front end for `recall find --fzf`