# callimachus

Indexes local chat transcripts across 11 AI coding assistants and exposes them via search. Helps agents recall earlier decisions without repeating mistakes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 46
- Author: BetaBots-LLC
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BetaBots-LLC/callimachus
- Updated: 2026-07-14
- HTML: https://affpapa.org/en/nevibecode/mcp/callimachus

## What it does

The server links your agent to Callimachus's local SQLite catalog. The background indexer monitors logs from 11 development tools, including Claude Code, Cursor, and Codex. Search fuses keyword hits from SQLite FTS5 with local sqlite-vec vector embeddings on your hardware. Everything remains strictly on the machine.

Through MCP, the agent interacts with past context in both directions. It queries threads by touched file paths, checks prior agreements via `check_decision`, and correlates git commits with the sessions that authored them. Agents can also write back into local storage, closing open action items or capturing session snapshots without modifying repo files.

Running the integration requires `npx` in your environment. Distilling takeaways and summaries works with a local Ollama instance or an active subscription in supported CLI agents. Without a configured language model, automated fact extraction stays disabled. The source is published under the AGPL-3.0 license.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add callimachus -- npx -y callimachus-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add callimachus -- npx -y callimachus-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "callimachus": {
            "command": "npx",
            "args": [
                "-y",
                "callimachus-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "callimachus": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "callimachus-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add callimachus npx -y callimachus-mcp
```

## When to use it
- locate previous discussions affecting a specific file path
- verify past architectural decisions before rewriting code
- attribute git commits to specific agent transcripts
- snapshot session context across agent compaction boundaries

## Example prompts
- Search Callimachus history for earlier discussions about database migrations.
- Check settled decisions regarding authentication before changing this route.
- Save a session snapshot with our current progress to project memory.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md