mnema: decision records for AI coding agents
Signed, append-only decision records for AI coding agents that live in your repository
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.1.8
- Listing updated
- 3 days ago
About mnema: decision records for AI coding agents
mnema: decision records for AI coding agents is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
mnema keeps a record of why choices were made, stored in a .mnema/ folder committed with your code. When a choice is settled, the agent writes it with the reason and what was rejected, and it counts once accepted. Each new session opens with the decisions in force, so the next agent starts from what was settled.
A decision can point at a path: an agent's edit there waits for a person or is refused with the rule named. The shell is not blocked. Every event is signed and hash-chained, and mnema verify checks the record offline without a key; it detects an altered word. The site calls it tamper-evident, not tamper-proof.
The package provides both the CLI and the MCP server. It writes instructions into AGENTS.md, CLAUDE.md or GEMINI.md and is Apache-2.0 with no account or server. A pre-registered test of 49 Claude Code sessions is published.
Install
Run in a terminal
claude mcp add mnema -- npx -y @mnema/codeAdd to claude_desktop_config.json
{
"mcpServers": {
"mnema": {
"command": "npx",
"args": [
"-y",
"@mnema/code"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mnema": {
"command": "npx",
"args": [
"-y",
"@mnema/code"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mnema": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mnema/code"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mnema": {
"command": "npx",
"args": [
"-y",
"@mnema/code"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mnema": {
"command": "npx",
"args": [
"-y",
"@mnema/code"
]
}
}
}What it does
- Append-only record
- Decisions are added, never edited.
- Session handoff
- New sessions open with decisions in force.
- Path rules
- Edits on governed paths wait or are refused.
- Offline verification
- `mnema verify` needs no key or network.
- Task handoffs
- Tasks carry descriptions and handoff briefs.
- Multi-host support
- Claude Code, Codex, Cursor, Gemini CLI and more.
Good for
- Stop agents reopening settled design choices
- Gate edits to sensitive paths
- Hand context between agent sessions
- Audit why a change was made
Pricing
Open source
Apache-2.0
Prices change. Check mnema.work before you buy.
mnema: decision records for AI coding agents FAQ
Where is the record stored?
In .mnema/ inside your repository.
Does it need an account?
No account or server.
Can the record be altered unnoticed?
Changes are detectable; it is tamper-evident, not tamper-proof.
What license?
Apache-2.0.
Is mnema: decision records for AI coding agents free?
Yes. mnema: decision records for AI coding agents is open source, so you can use and self-host it for free.
How do I add mnema: decision records for AI coding agents to Claude Code?
Run this command in your terminal: claude mcp add mnema -- npx -y @mnema/code
What are the best alternatives to mnema: decision records for AI coding agents?
The closest alternatives to mnema: decision records for AI coding agents are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to mnema: decision records for AI coding agents

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