Skip to content
MCP server

mnema: decision records for AI coding agents

Signed, append-only decision records for AI coding agents that live in your repository

Runs locallyStatus and history
Install
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/code

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mnema": {
      "command": "npx",
      "args": [
        "-y",
        "@mnema/code"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mnema": {
      "command": "npx",
      "args": [
        "-y",
        "@mnema/code"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools