Skip to content

Installing total-recall in an agent CLI

total-recall ships an MCP server (26 tools — recall, get_operator_context, check_banned, ...) and a session-ingest pipeline that reads transcripts from every supported agent CLI. The two surfaces are independent: a CLI that does not support MCP can still have its sessions ingested for backfill context.

CLI MCP Hooks Session ingest Doc
Claude Code yes yes — ingest before compact, recall on SessionStart compact yes claude_code.md
OpenCode yes plugin — ingest + recall appended on experimental.session.compacting yes opencode.md
Gemini CLI yes no yes gemini_cli.md
Codex CLI yes yes — same plugin hooks; recall on SessionStart compact yes codex.md
Cursor yes no yes cursor.md
Continue yes no yes continue.md
Cline yes no yes cline.md
Aider no no yes aider.md
Goose yes Stop/SessionEnd ingest only — no compaction hook yes goose.md
Pi yes extension — ingest on session_before_compact, recall on the next before_agent_start yes pi.md
Grok yes no yes grok.md

After installing

Verify the session-ingest side is finding what you expect:

total-recall sources list      # registry + config + on-disk status
total-recall sources detect    # only sources with detectable data
total-recall sources test <name>

Suppress a source you do not want indexed:

total-recall sources disable <name>

The CLI persists choices to ${CLAUDE_PLUGIN_DATA}/total-recall/sources.json. Default policy is all sources enabled — adapters with no on-disk data simply yield zero sessions.