Ariadne
Local-first multilingual memory for coding agents, with verified backups and isolation
- Pricing
- Open source
- Platforms
- Windows, macOS, Linux
- Runs
- Locally
- Version
- 0.8.26
- Listing updated
- 3 days ago
About Ariadne
Ariadne is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Ariadne replaces memory backends that crash or starve when several agent sessions write at once. Instead of an embedded database, it keeps memories in a Qdrant server bound to 127.0.0.1, with Ollama serving the bge-m3 model locally. Dense multilingual meaning and exact BM25 terms are fused for retrieval, so the site says an English query can find Ukrainian notes.
Projects are isolated by default. A search across another project opens a scoped approval request that a person must decide in the tray menu, so an agent cannot quietly read another project. Recent releases focus on backups: a failed backup stays a warning until a successful one completes, a new full set must pass independent file, database and model recovery checks before it replaces the kept one, and an explicit repair mode keeps earlier copies.
It is written in Go and runs without Docker, a cloud account or API keys. Windows has a native x64 installer, and a shell installer is provided for Mac and Linux. Memory can be exported as portable JSONL or saved as full Qdrant snapshots.
Install
Run in a terminal
claude mcp add ariadne -- npx -y https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"ariadne": {
"command": "npx",
"args": [
"-y",
"https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ariadne": {
"command": "npx",
"args": [
"-y",
"https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ariadne": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ariadne": {
"command": "npx",
"args": [
"-y",
"https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ariadne": {
"command": "npx",
"args": [
"-y",
"https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
]
}
}
}Configuration
ARIADNE_QDRANT_HOSTQdrant hostARIADNE_QDRANT_PORTQdrant gRPC portARIADNE_OLLAMAOllama API URLARIADNE_MODELEmbedding modelARIADNE_COLLECTIONQdrant collection
What it does
- Concurrent sessions
- Qdrant serves several agents at once without file-lock starvation.
- Multilingual recall
- bge-m3 embeddings plus BM25 across 100+ languages.
- Project isolation
- Cross-project recall needs a visible human approval.
- Verified backup rotation
- New backup sets pass recovery checks before replacing the old one.
- Visible failures
- Failed backups stay flagged and notify again on each new failure.
- Portable export
- JSONL export or full Qdrant snapshots for moving memories.
Good for
- Give Codex and Claude Code a shared memory across sessions
- Recall notes written in another language
- Keep one project's memory out of another's searches
- Back up agent memory with tested recovery
- Run agent memory fully offline
Pricing
Open source
Prices change. Check mclaut.github.io before you buy.
Ariadne FAQ
Does it send memory to the cloud?
No. The default stack uses local Qdrant and local Ollama endpoints.
Can several sessions use it at once?
Yes, Qdrant is a server and handles concurrent access natively.
Can an agent search another project silently?
No. Cross-project recall opens a scoped approval request first.
Can I move my memories later?
Yes, by exporting portable JSONL or taking full Qdrant snapshots.
Is Ariadne free?
Yes. Ariadne is open source, so you can use and self-host it for free.
How do I add Ariadne to Claude Code?
Run this command in your terminal: claude mcp add ariadne -- npx -y https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb
What are the best alternatives to Ariadne?
The closest alternatives to Ariadne are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Ariadne

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools