Muninn

Your AI coding agent forgets everything between sessions. Muninn fixes that.

npx muninn-ai

Muninn gives AI coding agents persistent memory via MCP. Before every edit, the agent knows what's fragile, what decisions were made, and what broke last time. After every session, it writes back what it learned. Knowledge compounds automatically.

Works with: Claude Code, Cursor, Windsurf, Continue.dev, and any MCP-compatible tool.

---

The Problem

AI coding agents are stateless. Every session starts from zero:

• They break things — editing a critical file with no idea it's fragile
• They contradict themselves — picking a different pattern than 3 sessions ago
• They repeat mistakes — re-introducing bugs that were already fixed
• They lose context — forgetting why something was done a certain way

4 Tools

Muninn exposes 4 tools to your AI agent:

Tool	Purpose
recall	Pre-edit context — fragility, co-changers, related decisions, open issues, blast radius
remember	Record decisions and learnings — auto-categorized, searchable across sessions
track	Bug lifecycle — add when found, resolve when fixed, surface when relevant
muninn	Everything else — status, reindex, fragile files, decision outcomes

What Compounds

Muninn gets smarter with every session:

• Fragility scoring — weighted composite of dependents, test coverage, change velocity, error history, complexity, and export surface
• File correlations — tracks which files change together to predict co-changes and warn about missed updates
• Learning graduation — patterns that prove true get promoted; contradicted ones get archived
• Decision grounding — architectural choices link to outcomes so the agent knows what worked and what didn't

Quick Start

Option 1: npx (Recommended)

npx muninn-ai

Installs Bun (if needed), clones the repo, registers the MCP server, and sets up hooks. One command.

Option 2: Manual Install

git clone https://github.com/ravnltd/muninn.git ~/.local/share/muninn
cd ~/.local/share/muninn && ./install.sh

First Run

On first session, Muninn auto-indexes your git history (last 100 commits) so recall returns useful context immediately. No setup needed.

Multi-Editor Support

After install, Muninn auto-detects and configures:

• Claude Code — MCP server + session hooks
• Cursor — .cursor/mcp.json
• Windsurf — .windsurf/mcp.json
• Continue.dev — .continue/config.json

Or register manually:

muninn setup --list    # See what's detected
muninn setup --all     # Configure all detected editors

Architecture

Bun + TypeScript + SQLite (via libsql/sqld). Runs as an MCP server over stdio. Local mode stores everything in .muninn/ per-project. HTTP mode connects to a shared sqld instance for multi-machine setups.

License

AGPL-3.0-only — free to use, modify, and share. If you run a modified version as a network service, you must release your source.

---

Built in collaboration with Claude Code.