mneme · genesis Stryx Labs
01 06 — Architecture
//01Architecture · 4 layers

What runs
on your machine.

AI host → MCP wire → Mneme daemon → local store. Everything sits on your disk. Nothing routes to a third-party cloud. One round-trip on blast_radius is ~20 ms p95.

//02Layer i · AI host

Claude. Cursor.
19+ tools.

Claude Code · Cursor · Codex · Windsurf · Zed · Gemini · Qwen · Claude Desktop — every modern AI coding host speaks MCP. Mneme registers as a stdio server.

i
AI host · 19+ tools wired

Auto-detected by Claude Code on install. Manual setup in 30 seconds for Cursor, Windsurf, Zed via mneme mcp. The same Mneme daemon serves every client simultaneously — open three editors, same memory.

//03Layer ii · MCP wire

Standard protocol.
Just stdio.

Model Context Protocol over JSON-RPC 2.0. No HTTP server. No port to leak. stdio with the AI host process and 8 Claude Code hooks for guidance.

ii
MCP wire · 49 tools · 8 hooks

Mneme exposes 49 MCP tools: find_references, call_graph, blast_radius, recall_concept, audit_corpus, and more. PreToolUse hooks softly redirect Grep calls toward structural find_references — never blocking, fail-open.

//04Layer iii · Mneme daemon

Rust supervisor.
11 scanners.

A long-running Rust process with watchdog + auto-restart. Symbol resolver for Rust, TypeScript, Python. 3-model embedder (BGE · Qwen · Phi-3) on CPU via ONNX Runtime. Optional local LLM via llama.cpp.

iii
Daemon · ~12 MB resident · CPU-only by default

Symbol-anchored embeddings survive renames and refactors. File watcher debounces edits, rebuilds the affected slice in under a second. 11 audit scanners run on schedule: security, performance, accessibility, reliability, drift detection, more.

//05Layer iv · Local store

27 layers.
One disk.

Sharded SQLite with WAL, FTS5, auto-VACUUM. Forward-only schema — your graph survives every upgrade. Lives at ~/.mneme. Graph diff between commits. 5 export formats.

Code
AST nodes per file
Symbols
Canonical map
Edges
Caller / callee graph
Embeddings
384-dim vectors
Communities
Graph clusters
Concepts
User-seeded memory
Decisions
Recorded reasoning
Todos
Outstanding work
Constraints
Rules per area
History
Session log + FTS
Ledger
Audit / change log
Steps
Compaction recovery
Drift
Rule drift detector
Wiki
Auto-generated
Federation
Cross-project (opt-in)
+12 more
Cache · metrics · schema
//06Privacy by design

Never
leaves your laptop.

No telemetry. No cloud sync. Daemon binds to 127.0.0.1 only. Outbound traffic on default install: zero bytes.

Source code

Never sent anywhere. AST + graph live in SQLite on your disk.

Embeddings

Computed on your CPU via ONNX Runtime. Never transmitted.

Daemon socket

Bound to 127.0.0.1 only. Origin-validated. DNS-rebinding-safe.

Telemetry

None. Mneme has no telemetry pipeline. Period.

Outbound traffic

Zero on default install. Only mneme update talks to the network.

Federation (opt-in)

Off by default. If on, only blake3-hashed signatures travel — never source code.