ccrider: search your Claude Code and Codex sessions
ccrider
A Go CLI that gathers Claude Code, Codex and Copilot sessions into one searchable base with a TUI and an MCP memory server
- 136 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads local agent session files with your code and conversations and copies them into a base
- Through MCP an agent sees the history of other sessions, including what you discussed in other projects
Install
- Works in
Manual install
brew install neilberkman/tap/ccriderHomebrew, the route the README recommends.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads local agent session files with your code and conversations and copies them into a base
- Through MCP an agent sees the history of other sessions, including what you discussed in other projects
This is third-party code. Review the repository files before installing.
What it does
ccrider finds agent sessions on disk and imports them into a local SQLite base with FTS5 full-text search. It supports Claude Code, Codex CLI, GitHub Copilot CLI, OpenCode, Pi, Antigravity and Amp. `ccrider sync` pulls in new ones, `ccrider search "query"` searches text with project and date filters, and `ccrider tui` opens a terminal interface. In the TUI arrows browse sessions, `Enter` shows the conversation, `r` launches the resume command of the chosen session in the right folder, and `o` opens it in a new terminal tab. Sessions from the current folder are highlighted. The `ccrider serve-mcp` command starts an MCP server: `search_sessions`, `list_recent_sessions`, `get_session_messages`, session anchors and waiting for signals between sessions. An agent asks it what you did before.
Who it is for. People who work with several coding agents and lose the thread: where the database migration was discussed, which bug was fixed last week.
Good fit when
- You recall that authentication was discussed in some Claude Code or Codex session and search by words
- You want to resume an old session from the TUI without hunting for its ID and folder
- A new agent forgot the context and you ask it through MCP to look at what was done in the project last week
- Claude Code and Codex run side by side and you need one search across their histories
Not a fit when
- Session history does not matter to you: ccrider adds nothing to the agent work itself
- You need cloud sharing of team sessions: the base is local
- The agent stores sessions in an unsupported format: the provider list is limited
Example request
Use ccrider to find the sessions where we edited the Postgres migration and show the last messages of the newest.Limitations
It works with local session files that different agents keep in their own folders, so coverage depends on the supported provider list. The Amp integration is off by default: enabling it downloads cloud thread text into the local SQLite base.
As a Homebrew cask `ccrider` is for macOS, while other systems build from Go source. The last commit is from November 2026.
How to disable. Remove the MCP server with `claude mcp remove ccrider`, then uninstall the binary (`brew uninstall --cask ccrider`) and delete the local SQLite base.
FAQ
Which agents does ccrider support?
Claude Code, Codex CLI, GitHub Copilot CLI, OpenCode, Pi, Antigravity (CLI, IDE and app) and Amp. Each session in the TUI is tagged with its provider.
How do I connect the MCP server to Claude Code?
With `claude mcp add --scope user ccrider $(which ccrider) serve-mcp`. For Claude Desktop add a server with the command `ccrider` and arguments `["serve-mcp"]`.
How do I resume an old session?
Open `ccrider tui`, select a session and press `r`: the resume command launches in the right folder. `c` copies it and `o` opens it in a new tab.
What are session anchors?
They are bookmarks: `generate_session_anchor` saves a label such as `add-rest-endpoint-a12bc34de56f`, and `list_session_anchors` shows saved anchors and their matching sessions.
Where does ccrider keep its base and is the data safe to trust to it?
The base is local, SQLite with an FTS5 index. MCP requests do not reach the network for Amp data: they search the cache already downloaded locally.
Discussion
No questions or reviews yet.
Related
CLI toolsStreams Claude Code hidden thinking, tool calls and subagents to a separate terminal with a live session tree
Codex Trace reads local Codex CLI logs and shows turns, tool calls and token usage in a desktop window or in the browser.
CCManager is a session manager for Claude Code, Codex, Gemini CLI and other agents: each runs in its own Git worktree with status and hooks
A TUI that shows what Claude Code, Codex, Gemini CLI and opencode do in a project: the open file, last-commit diff, live commands
agentplay turns local Claude Code, Codex and Cursor sessions into a file map and a replayable step timeline.
A CLI records coding agent sessions locally, replays what happened and shows what the trace could not prove.
README in short
The README shows how to gather the history of different agents into one base, install through Homebrew and from source, the TUI with hotkeys, filtered search, session resume and an MCP server with seven tools.