CLAUDE PLUGIN

munin-memory

Publisher not specified · Claude Code

What this plugin does

# Munin for Claude Code

> **Munin** is a long-term memory system for developers. Every time you work with Claude Code, Munin remembers your context, decisions, bugs, and solutions — so you never have to repeat yourself.

**Munin** is your project's memory companion, integrated directly into Claude Code. It remembers your project, finds past errors, and suggests solutions based on what you've done before.

---

## Features

### 🤖 Munin Agent
Call `@munin` in any conversation to talk directly with your project's memory. Munin has full access to your memories — search, retrieve, store — all following the Memory Index Protocol.

### 🔍 Automatic Memory Search
Every time you start a Claude Code session, Munin automatically finds relevant memories from your project. No need to ask — context is already there.

### 💾 Session Summarization
When a session ends, Munin automatically saves a summary to memory. Tasks, decisions, bugs — everything is recorded.

### 📚 Error Catalog
When an error occurs, Munin will:
1. **Search** the error catalog first — a fix might already exist
2. **Fix** following the precedent
3. **Store** the new resolution so the next time is faster

### 🧠 GraphRAG Memory
Every memory is automatically indexed into a knowledge graph:
- **Entities** — services, libraries, models are extracted
- **Relationships** — connections between components are mapped
- **Semantic search** — find anything using natural language

---

## How It Works

```
You open Claude Code
│
▼
SessionStart Hook
→ Munin searches relevant memories
→ Context injected into conversation
│
▼
You work on your task
→ Munin monitors for errors
→ Errors → Error Catalog
│
▼
Session ends (or /compact)
→ Summary saved to memory
│
▼
Next session — Munin remembers
```

---

## Quick Start

### 1. Create a Free Munin Account

After signing up, create a new project and copy your **Project ID** (`proj_xxxxxxxxxxxx`).

### 2. Add Your Project ID

Create or edit `.env` in your project root:

```bash
MUNIN_PROJECT=proj_your_project_id
```

### 3. Enable the MCP Server

**Option A — Global (recommended, works in any project):**
```bash
# Download the Munin MCP wrapper
curl -fsSL https://raw.githubusercontent.com/3d-era/munin/main/scripts/munin-mcp-wrapper.sh \
-o ~/.claude/munin-mcp-wrapper.sh
chmod +x ~/.claude/munin-mcp-wrapper.sh

# Enable globally
claude mcp add --scope user munin bash ~/.claude/munin-mcp-wrapper.sh
```

**Option B — Project-specific:**
```bash
claude mcp add --scope project munin bash -c '
ENV_FILE="$(pwd)/.env"
if [[ -f "$ENV_FILE" ]]; then
while IFS="=" read -r key rest; do
[[ "$key" =~ ^[[:space:]]*# ]] && continue
[[ -z "$key" ]] && continue
key=$(echo "$key" | sed "s/^[[:space:]]*//;s/[[:space:]]*$//")
value=$(echo "$rest" | sed "s/^[[:space:]]*//;s/#.*$//;s/[[:space:]]*$//")
[[ -n "$value" ]] && export "$key=$value" 2>/dev/null || true
done < "$ENV_FILE"
fi
exec npx @kalera/munin-claude mcp
'
```

**Option C — From this repo (development):**
```bash
claude mcp add --scope user munin bash -c '
PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
ENV_FILE="$PROJECT_DIR/.env"
if [[ -f "$ENV_FILE" ]]; then
grep -E "^MUNIN_PROJECT=" "$ENV_FILE" | while IFS="=" read -r key val; do
export "$key=$val"
done
fi
exec npx @kalera/munin-claude mcp
'
```

### 4. Start Using

```bash
# Talk to Munin directly
@munion ask about the SePay integration
@munion what did we decide about the auth system?

# Or just start working — Munin auto-loads context
# Munin will remember everything when you finish
```

---

## Configuration

### Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `MUNIN_PROJECT` | *(required)* | Your project ID from munin.kalera.app |
| `MUNIN_BASE_URL` | `https://munin.kalera.dev` | Munin API server |
| `MUNIN_API_KEY` | *(from dashboard)* | API key for authentication |

### Self-hosted Munin

If you're running your own Munin instance:

```bash
MUNIN_BASE_URL=https://your-munin-instance.com \
claude mcp add --scope user munin bash -c \
'MUNIN_BASE_URL="https://your-munin-instance.com" exec npx @kalera/munin-claude mcp'
```

---

## Skills — What Triggers Munin

Munin activates automatically based on context:

| Skill | Triggers | What It Does |
|-------|----------|--------------|
| `munin-memory` | "search memory", "remember", "find in memory" | Full memory operations |
| `munin-architecture` | "architecture", "tech stack", "system design" | Architecture context |
| `munin-error-catalog` | "bug", "error", "crash", "doesn't work" | Error resolution |

---

## Memory Protocol — How Munin Works

### At Task Start
1. `munin_search_memories` with keywords relevant to the task
2. `munin_retrieve_memory` for detailed context
3. Present findings — **verify from memory, don't guess**

### At Task End
`munin_store_memory` with:
- **title**: Concise summary (max 80 chars)
- **content**: Details including file paths, decisions, outcomes
- **tags**: Categories (`task`, `architecture`, `bug-fix`, etc.)

### On Bug Fixes
1. Search error catalog first
2. Present existing fix if found
3. Fix and **store the new resolution**

### On Decisions
Tag as `architecture` + `decision`, include timeline/version

---

## Pricing

| Plan | Price | Memories | Projects |
|------|-------|----------|----------|
| **Free** | $0 | 500 | 3 |
| Pro | $9/mo | Unlimited | Unlimited |
| Team | $29/mo | Unlimited | Unlimited |

**[Sign up at munin.kalera.app →](https://munin.kalera.app)**

---

## Resources

| Resource | Link |
|----------|------------------------------------------------------------------------------------------------|
| 🌐 **Website** | [munin.kalera.app](https://munin.kalera.app) |
| 📖 **Docs** | [munin.kalera.app/docs](https://munin.kalera.app/docs) |
| 💬 **Discord** | Coming soon |
| 🐛 **Issues** | [github.com/3d-era/munin-for-agents/issues](https://github.com/3d-era/munin-for-agents/issues) |
| 📦 **npm** | [npmjs.com/package/@kalera/munin-claude](https://npmjs.com/package/@kalera/munin-claude) |
| 🔌 **Gemini Extension** | [github.com/3d-era/munin-gemini-extension](https://github.com/3d-era/munin-gemini-extension) |

---

## License

MIT — [github.com/3d-era/munin-for-agents](https://github.com/3d-era/munin-for-agents)

Publisher website ↗

Catalog observations

Sources: Community
Works with: Claude Code
Reported installs: Not provided
First observed: 2026-10-03 22:13 UTC
Last observed: 2026-10-11 06:00 UTC

Installation counts are reported by Claude Marketplace, not independently verified active users. Observation dates are not release dates. Pricing and account requirements must be checked with the publisher.

Install in Claude Code

Choose a source and review what the plugin adds before installing.

Community

/plugin marketplace add anthropics/claude-plugins-community
/plugin install munin-memory@claude-community

Claude Code installation documentation

Source evidence

Listing and manifest JSON

Descriptions and compatibility labels come from the linked sources. Where both sources match, the GitHub description is used because web summaries may be shortened. We have not independently tested the declared capabilities.