Semantic memory
HNSW vector search over local embeddings for fast recall from agent context.
Ironrace
Memory for AI agents that outlives the session.
ironmem is an open-source Rust MCP server that gives Codex, Claude Code, and any MCP client a private semantic memory: search, diary, taxonomy, and knowledge-graph tools over one local SQLite store. No cloud, no Python — a single binary that starts serving in under 25 ms.
- Local-first
- Private by default
- Single binary
- Apache-2.0
What ships today
One local server, one database, and a tool surface agents can share.
Pure Rust embeddings
ONNX sentence embeddings live inside the workspace through ironrace-embed.
MCP server
Expose status, search, diary, graph, taxonomy, and collaboration tools over stdio.
Knowledge graph
Structured facts and semantic drawers can be queried together as memory grows.
Shared across harnesses
Codex and Claude Code read and write the same SQLite store by default.
Agent collaboration
Bounded Claude↔Codex planning and coding sessions run over the shared store.
Install ironmem
The source quickstart builds the binary, runs setup, then starts the trusted MCP server.
git clone https://github.com/ironrace/ironmem.git
cd ironmem
scripts/install-ironmem.sh
~/.ironrace/bin/ironmem setup
IRONMEM_MCP_MODE=trusted ~/.ironrace/bin/ironmem servePrebuilt binaries
macOS (arm64) and Linux (x86_64) tarballs ship with every tagged release, with SHA-256 checksums.
Download a release →Smoke test
Validate stdio startup without downloading the model:
python3 scripts/mcp_smoke_test.py --binary ~/.ironrace/bin/ironmem
Codex config
Point Codex at the installed binary and set trusted mode when write tools are needed.
Open Codex setup →Works across harnesses
ironmem is built for local agent workflows where memory should outlive one chat window.
OpenAI Codex
Use ironmem as a local MCP server for shared search, status, graph, and write tools.
Setup guide →Claude Code
Plugin packaging is included so both harnesses can use the same memory database.
Collab guide →Rust projects
ironrace-core and ironrace-embed provide the shared index and embedding layers.
Browse crates →GitHub
ironmem is developed in the open under the Apache-2.0 license.