Shared persistent memory across Claude Chat, Code, and Cowork.
Acheron
Shared persistent memory across Claude Chat, Code, and Cowork.
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Chat │ │ Code │ │ Cowork │
└─────┬─────┘ └─────┬─────┘ └─────┬─────┘
│ │ │
└────────┬────────┴────────┬─────────┘
│ │
┌─────▼─────────────────▼─────┐
│ Acheron MCP │
│ ┌───────────────────────┐ │
│ │ ~/.acheron/bridge.db │ │
│ └───────────────────────┘ │
└─────────────────────────────┘
Local · No cloud
Save a decision in Chat. Retrieve it in Cowork. Search for it from Code. All local, all offline, zero configuration.
Install
Claude Desktop (recommended)
This connects Acheron to all surfaces — Chat, Code, Cowork, and Dispatch. This is the recommended setup for full cross-surface bridging.
Open Claude Desktop → Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"acheron": {
"command": "npx",
"args": ["-y", "acheron-mcp-server"]
}
}
}
Restart Claude Desktop.
Claude Code only
If you only need Acheron in Claude Code (terminal / IDE):
claude mcp add acheron -- npx -y acheron-mcp-server
Requires Node.js 20+. Native build tools may be needed for better-sqlite3 (details).
Usage
Just talk naturally. Acheron's tool descriptions are written so Claude uses them automatically.
Save context — say "remember this", "save this decision", "note that we chose X":
"Remember: we're using Next.js App Router for the acme-site project."
Search context — say "what did I decide about...", "find my notes on...":
"What did we decide about the authentication approach?"
Browse context — say "show me my preferences", "list all decisions for this project":
"Show me everything saved for acme-site."
How it works
Acheron is an MCP server. It stores context in a local SQLite database (~/.acheron/bridge.db) with full-text search. No cloud, no network calls, no telemetry. Data never leaves your machine.
Six tools, all prefixed bridge_:
| Tool | Purpose |
|---|---|
bridge_save_context |
Remember decisions, preferences, insights, notes |
bridge_get_context |
Retrieve full details of a saved context |
bridge_search_context |
Full-text search across all saved contexts |
bridge_list_contexts |
Browse and filter by project, surface, type, tags |
bridge_delete_context |
Forget a saved context |
bridge_status |
Overview of what's stored |
Troubleshooting
better-sqlite3 install fails? You need native build tools:
- macOS:
xcode-select --install - Linux:
sudo apt install build-essential - Windows: Visual Studio Build Tools
Database issues? Delete ~/.acheron/bridge.db — Acheron recreates it on next start.
License
MIT
Tools (6)
bridge_save_contextRemember decisions, preferences, insights, and notes.bridge_get_contextRetrieve full details of a saved context.bridge_search_contextFull-text search across all saved contexts.bridge_list_contextsBrowse and filter by project, surface, type, and tags.bridge_delete_contextForget a saved context.bridge_statusOverview of what is stored.Configuration
{"mcpServers": {"acheron": {"command": "npx", "args": ["-y", "acheron-mcp-server"]}}}