# mnema: decision records for AI coding agents

mnema: decision records for AI coding agents is an MCP server for Claude Code that keeps signed, append-only architectural decision records in a repository and passes project conventions into agent sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: mnema-work
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mnema-work/mnema/tree/HEAD/packages/code
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mnema-decision-records-for-ai-coding-agents

## What it does

The package bundles a terminal CLI and an MCP server reading from a shared `.mnema/` record tree. Agents log architectural choices through MCP while modifying files, and developers review pending items from the command line. Every record entry is cryptographically signed, making history verifiable offline without external networks or private keys.

The system tracks tasks with contextual notes up to 64 KiB, handles subagent handoffs, and can inherit rules from pinned commits of parent repositories. Running the tool requires Node.js 24.15.0 or 26.0.0+. Automatic linters invalidate record signatures, which is why `mnema init` isolates `.mnema/` inside `.prettierignore` and Biome settings.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mnema -- npx -y @mnema/code
```

### Codex

**Platform CLI**
```bash
codex mcp add code -- npx -y @mnema/code
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "code": {
            "command": "npx",
            "args": [
                "-y",
                "@mnema/code"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "code": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mnema/code"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add code npx -y @mnema/code
```

## When to use it
- commit signed append-only architectural records straight into git
- verify repository decision chains locally without internet access or private keys
- inject active coding constraints into newly opened agent workspaces
- store task progress and handoff briefs with payloads up to 64 KiB

## Example prompts
- Review the decision log and show active rules governing this repository
- Create a task in mnema detailing the auth service refactoring
- Record the architectural decision regarding the database migration

## Similar
- [architecture-decision-records](https://affpapa.org/en/nevibecode/skills/architecture-decision-records.md) — skill · 22036 installs
- [decision-records](https://affpapa.org/en/nevibecode/skills/decision-records.md) — skill · 8600 installs
- [coding-agent](https://affpapa.org/en/nevibecode/skills/coding-agent.md) — skill · 6500 installs
- [grounding-before-coding](https://affpapa.org/en/nevibecode/skills/grounding-before-coding.md) — skill · 25600 installs
- [vibe-coding](https://affpapa.org/en/nevibecode/skills/jamditis-vibe-coding.md) — skill · 203 installs
- [decision-map](https://affpapa.org/en/nevibecode/skills/decision-map.md) — skill · ★ 937 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
