muninn

# Muninn

[![npm](https://img.shields.io/npm/v/muninn-ai?color=blue)](https://www.npmjs.com/package/muninn-ai)
[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
[![GitHub stars](https://img.shields.io/github/stars/ravnltd/muninn)](https://github.com/ravnltd/muninn)

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

```bash
npx muninn-ai
```

Muninn gives AI coding agents persistent memory via [MCP](https://modelcontextprotocol.io/). 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
- **Learn