TL;DR
ccrider is an open-source command-line tool that indexes Claude Code session files so you can search, browse and resume past conversations from the terminal. It provides a TUI browser, full-text CLI search powered by SQLite FTS5, incremental sync/import, and an optional MCP server so Claude can query your local session history.
What happened
A new open-source tool named ccrider organizes Claude Code sessions stored under ~/.claude/projects/ and exposes them through a terminal UI, command-line search, and an MCP server. Users import sessions with ccrider sync and then browse conversations with a Bubbletea-based TUI (ccrider tui) that supports navigation, project filtering, inline search and one-key resume. The CLI offers instant full-text search via SQLite FTS5 (ccrider search) with project and date filters, and ccrider resume launches claude –resume in the correct working directory. The importer supports incremental sync to avoid reprocessing ongoing sessions. An optional MCP server (ccrider serve-mcp) exposes read-only tools for Claude to list and search sessions; configuration lives in ~/.config/ccrider and the repo includes a Homebrew formula and instructions to build from source with Go. The project is licensed under MIT and is organized with a strict core/interface separation in Go.
Why it matters
- Makes buried Claude Code conversations discoverable and actionable from the terminal instead of grepping nested JSON.
- Full-text search (FTS5) and project/date filters speed retrieval of relevant messages across many sessions.
- Native resume integration launches Claude in the right directory and session context, reducing manual setup.
- Optional MCP server enables Claude itself to query your local session history while keeping data local.
Key facts
- Sessions are typically located in ~/.claude/projects/ and can be imported with ccrider sync.
- Interactive terminal UI available via ccrider tui with keyboard navigation, search (/), project filter (p) and resume (r).
- Full-text CLI search implemented with SQLite FTS5: ccrider search "query" –project <path> –after <date>.
- Resume support: ccrider resume <session-id> launches claude –resume in the proper directory.
- Incremental sync detects ongoing sessions and avoids re-processing unchanged data; full re-import is available with –full.
- Includes a read-only MCP server offering tools like search_sessions, list_recent_sessions and get_session_messages.
- Configuration files are read from ~/.config/ccrider/ (config.toml, terminal_command.txt, resume_prompt.txt).
- Project is written in Go, uses Bubbletea for the TUI, and is distributed as a single binary; Homebrew formula available.
- Repository includes documentation, CONTRIBUTING.md, LICENSE (MIT) and CI/workflows.
What to watch next
- Repository activity and releases on the project's GitHub page for bug fixes and updates.
- not confirmed in the source
- not confirmed in the source
Quick glossary
- TUI: Text-based user interface that runs in a terminal and supports keyboard-driven interaction.
- MCP (Model Context Protocol): A protocol that lets models or tooling access contextual data or services; here it exposes session search/listing endpoints.
- SQLite FTS5: A full-text search extension for SQLite that enables efficient text indexing and querying.
- Bubbletea: A Go library for building rich terminal user interfaces.
Reader FAQ
How do I install ccrider?
You can install via Homebrew (brew install neilberkman/tap/ccrider) or build from source with go build and move the binary to /usr/local/bin/.
Can Claude access my session history through ccrider?
Yes — ccrider can run a local MCP server (ccrider serve-mcp) that gives Claude read-only access to the indexed sessions; the project states conversations remain local.
How do I resume a past session?
Use the TUI (press r) or the CLI command ccrider resume <session-id>, which launches claude –resume in the correct directory.
Is ccrider cross-platform?
not confirmed in the source
ccrider Search, browse, and resume your Claude Code sessions. Fast. Why ccrider? You've got months of Claude Code sessions sitting in ~/.claude/projects/. Finding that conversation where you fixed the authentication…
Sources
- Show HN: ccrider – Search and Resume Your Claude Code Sessions – TUI / MCP / CLI
- Ccrider
- pchalasani/claude-code-tools
Related posts
- DatBench: Toward Discriminative, Faithful and Efficient VLM Evaluation
- Hierarchical Autoregressive Modeling Boosts Memory Efficiency in Language Generation
- Claude Opus 4.5 Delivers an Unusually Capable AI Coding Agent