Best for
- Developers who want to search their coding agent history
- Users who work with multiple AI coding tools
- Local-first workflows prioritizing data privacy
C
Callimachus
Community
Local index & search for your AI coding-agent history.
GitHub source repository ↗
64FMRS · C
This MCP server provides a comprehensive set of tools for indexing and searching coding agent history, with both read and write operations. It is designed to be local-first, with all data stored locally. The server is part of a larger ecosystem that includes a desktop app and a CLI.
Callimachus is a local-first tool that indexes and searches your history of AI coding agents like Claude Code, Codex, Cursor, and more. It stores all conversations in a local SQLite database, provides hybrid search (keyword and semantic), and comes with an MCP server, a CLI, and a VS Code extension. It is open source under AGPL-3.0 and runs entirely on your machine with no cloud dependency.
Tools
search_threads
Search coding agent threads across all sources.
search_current_project
Search threads within the repository it runs in.
recent_threads
Get recent threads.
get_thread
Get detailed information about a specific thread.
list_tags
List all available tags.
list_open_todos
List all open TODOs.
get_thread_knowledge
Get distilled knowledge (decisions, gotchas) from a thread.
recall_decisions
Recall past decisions.
recall_gotchas
Recall past gotchas.
find_prior_work
Find historical sessions similar to a task.
project_memory
Get aggregated memory for a project.
ask_history
Ask a question about your history and get a cited answer.
threads_for_file
Find which threads touched a specific file path.
check_decision
Surface settled decisions before re-litigating a proposal.
linked_commits
Get commits that a thread likely produced.
list_snapshots
List session snapshots for a project.
load_snapshot
Restore a saved checkpoint.
complete_todo
Close an open TODO.
record_decision
Record a decision into a project's memory.
record_gotcha
Record a gotcha into a project's memory.
snapshot_session
Checkpoint a thread for handoff.
Setup
Run with npx: npx -y callimachus-mcp. You can add it to an MCP-capable client with claude mcp add callimachus -- npx -y callimachus-mcp.
Fit and risk
Not for
- Users who need cloud sync or remote access
- Users who do not use coding agents (the MCP server offers little value)
Required permissions
- Needs to access the local index database
- May execute commands to index coding agent history via the CLI
Risks and side effects
- Indexing can be resource-intensive, especially during the initial build
- The local index may contain sensitive data but it never leaves the device
Troubleshooting
- If the MCP server fails to start, ensure Node.js is installed correctly
- For issues with npx, check network connectivity and retry
- If you use the desktop app, ensure it is running to access the shared index
Use cases
Developers who want to search past problems and solutions from their coding agent sessions
Teams maintaining a project knowledge base across AI tools
People who want to resume agent sessions after a context window compaction
Supported clients
Claude DesktopFull support