# mnema: decision records for AI coding agents

> mnema: decision records for AI coding agents is an open-source MCP server for developer tools. Signed, append-only decision records for AI coding agents that live in your repository. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://mnema.work
- **Repository:** https://github.com/mnema-work/mnema/tree/HEAD/packages/code
- **MCP Registry name:** io.github.mnema-work/mnema
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mnema -- npx -y @mnema/code
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mnema": {
      "command": "npx",
      "args": [
        "-y",
        "@mnema/code"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mnema": {
      "command": "npx",
      "args": [
        "-y",
        "@mnema/code"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mnema": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mnema/code"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mnema": {
      "command": "npx",
      "args": [
        "-y",
        "@mnema/code"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mnema": {
      "command": "npx",
      "args": [
        "-y",
        "@mnema/code"
      ]
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mnema-decision-records-for-ai-coding-agents
