{"slug":"munin-memory","title":"munin-memory","description":"# Munin for Claude Code\n\n> **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.\n\n**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.\n\n---\n\n## Features\n\n### 🤖 Munin Agent\nCall `@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.\n\n### 🔍 Automatic Memory Search\nEvery time you start a Claude Code session, Munin automatically finds relevant memories from your project. No need to ask — context is already there.\n\n### 💾 Session Summarization\nWhen a session ends, Munin automatically saves a summary to memory. Tasks, decisions, bugs — everything is recorded.\n\n### 📚 Error Catalog\nWhen an error occurs, Munin will:\n1. **Search** the error catalog first — a fix might already exist\n2. **Fix** following the precedent\n3. **Store** the new resolution so the next time is faster\n\n### 🧠 GraphRAG Memory\nEvery memory is automatically indexed into a knowledge graph:\n- **Entities** — services, libraries, models are extracted\n- **Relationships** — connections between components are mapped\n- **Semantic search** — find anything using natural language\n\n---\n\n## How It Works\n\n```\nYou open Claude Code\n│\n▼\nSessionStart Hook\n→ Munin searches relevant memories\n→ Context injected into conversation\n│\n▼\nYou work on your task\n→ Munin monitors for errors\n→ Errors → Error Catalog\n│\n▼\nSession ends (or /compact)\n→ Summary saved to memory\n│\n▼\nNext session — Munin remembers\n```\n\n---\n\n## Quick Start\n\n### 1. Create a Free Munin Account\n\nSign up at [munin.kalera.app](https://munin.kalera.app) — FREE FOREVER.\n\nAfter signing up, create a new project and copy your **Project ID** (`proj_xxxxxxxxxxxx`).\n\n### 2. Add Your Project ID\n\nCreate or edit `.env` in your project root:\n\n```bash\nMUNIN_PROJECT=proj_your_project_id\n```\n\n### 3. Enable the MCP Server\n\n**Option A — Global (recommended, works in any project):**\n```bash\n# Download the Munin MCP wrapper\ncurl -fsSL https://raw.githubusercontent.com/3d-era/munin/main/scripts/munin-mcp-wrapper.sh \\\n-o ~/.claude/munin-mcp-wrapper.sh\nchmod +x ~/.claude/munin-mcp-wrapper.sh\n\n# Enable globally\nclaude mcp add --scope user munin bash ~/.claude/munin-mcp-wrapper.sh\n```\n\n**Option B — Project-specific:**\n```bash\nclaude mcp add --scope project munin bash -c '\nENV_FILE=\"$(pwd)/.env\"\nif [[ -f \"$ENV_FILE\" ]]; then\nwhile IFS=\"=\" read -r key rest; do\n[[ \"$key\" =~ ^[[:space:]]*# ]] && continue\n[[ -z \"$key\" ]] && continue\nkey=$(echo \"$key\" | sed \"s/^[[:space:]]*//;s/[[:space:]]*$//\")\nvalue=$(echo \"$rest\" | sed \"s/^[[:space:]]*//;s/#.*$//;s/[[:space:]]*$//\")\n[[ -n \"$value\" ]] && export \"$key=$value\" 2>/dev/null || true\ndone < \"$ENV_FILE\"\nfi\nexec npx @kalera/munin-claude mcp\n'\n```\n\n**Option C — From this repo (development):**\n```bash\nclaude mcp add --scope user munin bash -c '\nPROJECT_DIR=\"${CLAUDE_PROJECT_DIR:-$(pwd)}\"\nENV_FILE=\"$PROJECT_DIR/.env\"\nif [[ -f \"$ENV_FILE\" ]]; then\ngrep -E \"^MUNIN_PROJECT=\" \"$ENV_FILE\" | while IFS=\"=\" read -r key val; do\nexport \"$key=$val\"\ndone\nfi\nexec npx @kalera/munin-claude mcp\n'\n```\n\n### 4. Start Using\n\n```bash\n# Talk to Munin directly\n@munion ask about the SePay integration\n@munion what did we decide about the auth system?\n\n# Or just start working — Munin auto-loads context\n# Munin will remember everything when you finish\n```\n\n---\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `MUNIN_PROJECT` | *(required)* | Your project ID from munin.kalera.app |\n| `MUNIN_BASE_URL` | `https://munin.kalera.dev` | Munin API server |\n| `MUNIN_API_KEY` | *(from dashboard)* | API key for authentication |\n\n### Self-hosted Munin\n\nIf you're running your own Munin instance:\n\n```bash\nMUNIN_BASE_URL=https://your-munin-instance.com \\\nclaude mcp add --scope user munin bash -c \\\n'MUNIN_BASE_URL=\"https://your-munin-instance.com\" exec npx @kalera/munin-claude mcp'\n```\n\n---\n\n## Skills — What Triggers Munin\n\nMunin activates automatically based on context:\n\n| Skill | Triggers | What It Does |\n|-------|----------|--------------|\n| `munin-memory` | \"search memory\", \"remember\", \"find in memory\" | Full memory operations |\n| `munin-architecture` | \"architecture\", \"tech stack\", \"system design\" | Architecture context |\n| `munin-error-catalog` | \"bug\", \"error\", \"crash\", \"doesn't work\" | Error resolution |\n\n---\n\n## Memory Protocol — How Munin Works\n\n### At Task Start\n1. `munin_search_memories` with keywords relevant to the task\n2. `munin_retrieve_memory` for detailed context\n3. Present findings — **verify from memory, don't guess**\n\n### At Task End\n`munin_store_memory` with:\n- **title**: Concise summary (max 80 chars)\n- **content**: Details including file paths, decisions, outcomes\n- **tags**: Categories (`task`, `architecture`, `bug-fix`, etc.)\n\n### On Bug Fixes\n1. Search error catalog first\n2. Present existing fix if found\n3. Fix and **store the new resolution**\n\n### On Decisions\nTag as `architecture` + `decision`, include timeline/version\n\n---\n\n## Pricing\n\n| Plan | Price | Memories | Projects |\n|------|-------|----------|----------|\n| **Free** | $0 | 500 | 3 |\n| Pro | $9/mo | Unlimited | Unlimited |\n| Team | $29/mo | Unlimited | Unlimited |\n\n**[Sign up at munin.kalera.app →](https://munin.kalera.app)**\n\n---\n\n## Resources\n\n| Resource | Link                                                                                           |\n|----------|------------------------------------------------------------------------------------------------|\n| 🌐 **Website** | [munin.kalera.app](https://munin.kalera.app)                                                   |\n| 📖 **Docs** | [munin.kalera.app/docs](https://munin.kalera.app/docs)                                         |\n| 💬 **Discord** | Coming soon                                                                                    |\n| 🐛 **Issues** | [github.com/3d-era/munin-for-agents/issues](https://github.com/3d-era/munin-for-agents/issues) |\n| 📦 **npm** | [npmjs.com/package/@kalera/munin-claude](https://npmjs.com/package/@kalera/munin-claude)       |\n| 🔌 **Gemini Extension** | [github.com/3d-era/munin-gemini-extension](https://github.com/3d-era/munin-gemini-extension)   |\n\n---\n\n## License\n\nMIT — [github.com/3d-era/munin-for-agents](https://github.com/3d-era/munin-for-agents)","developer":null,"category":null,"reported_installs":null,"active":true,"first_seen_at":"2026-10-03T22:13:33.942Z","last_seen_at":"2026-10-11T12:00:02.907Z","last_changed_at":"2026-10-03T22:13:33.942Z","platform":"claude","sources":["Community"],"works_with":["Claude Code"],"marketplace_url":null,"repository_url":"3d-era/munin-for-agents","web_data":{},"github_data":{},"catalog_sources":{"community":[{"name":"munin-memory","source":{"ref":"main","sha":"b4366744828e5c51fd6b7d788aea13d261a8f35f","url":"3d-era/munin-for-agents","path":"plugins/munin-claude-code","source":"git-subdir"},"homepage":"https://munin.kalera.app","description":"# Munin for Claude Code\n\n> **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.\n\n**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.\n\n---\n\n## Features\n\n### 🤖 Munin Agent\nCall `@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.\n\n### 🔍 Automatic Memory Search\nEvery time you start a Claude Code session, Munin automatically finds relevant memories from your project. No need to ask — context is already there.\n\n### 💾 Session Summarization\nWhen a session ends, Munin automatically saves a summary to memory. Tasks, decisions, bugs — everything is recorded.\n\n### 📚 Error Catalog\nWhen an error occurs, Munin will:\n1. **Search** the error catalog first — a fix might already exist\n2. **Fix** following the precedent\n3. **Store** the new resolution so the next time is faster\n\n### 🧠 GraphRAG Memory\nEvery memory is automatically indexed into a knowledge graph:\n- **Entities** — services, libraries, models are extracted\n- **Relationships** — connections between components are mapped\n- **Semantic search** — find anything using natural language\n\n---\n\n## How It Works\n\n```\nYou open Claude Code\n│\n▼\nSessionStart Hook\n→ Munin searches relevant memories\n→ Context injected into conversation\n│\n▼\nYou work on your task\n→ Munin monitors for errors\n→ Errors → Error Catalog\n│\n▼\nSession ends (or /compact)\n→ Summary saved to memory\n│\n▼\nNext session — Munin remembers\n```\n\n---\n\n## Quick Start\n\n### 1. Create a Free Munin Account\n\nSign up at [munin.kalera.app](https://munin.kalera.app) — FREE FOREVER.\n\nAfter signing up, create a new project and copy your **Project ID** (`proj_xxxxxxxxxxxx`).\n\n### 2. Add Your Project ID\n\nCreate or edit `.env` in your project root:\n\n```bash\nMUNIN_PROJECT=proj_your_project_id\n```\n\n### 3. Enable the MCP Server\n\n**Option A — Global (recommended, works in any project):**\n```bash\n# Download the Munin MCP wrapper\ncurl -fsSL https://raw.githubusercontent.com/3d-era/munin/main/scripts/munin-mcp-wrapper.sh \\\n-o ~/.claude/munin-mcp-wrapper.sh\nchmod +x ~/.claude/munin-mcp-wrapper.sh\n\n# Enable globally\nclaude mcp add --scope user munin bash ~/.claude/munin-mcp-wrapper.sh\n```\n\n**Option B — Project-specific:**\n```bash\nclaude mcp add --scope project munin bash -c '\nENV_FILE=\"$(pwd)/.env\"\nif [[ -f \"$ENV_FILE\" ]]; then\nwhile IFS=\"=\" read -r key rest; do\n[[ \"$key\" =~ ^[[:space:]]*# ]] && continue\n[[ -z \"$key\" ]] && continue\nkey=$(echo \"$key\" | sed \"s/^[[:space:]]*//;s/[[:space:]]*$//\")\nvalue=$(echo \"$rest\" | sed \"s/^[[:space:]]*//;s/#.*$//;s/[[:space:]]*$//\")\n[[ -n \"$value\" ]] && export \"$key=$value\" 2>/dev/null || true\ndone < \"$ENV_FILE\"\nfi\nexec npx @kalera/munin-claude mcp\n'\n```\n\n**Option C — From this repo (development):**\n```bash\nclaude mcp add --scope user munin bash -c '\nPROJECT_DIR=\"${CLAUDE_PROJECT_DIR:-$(pwd)}\"\nENV_FILE=\"$PROJECT_DIR/.env\"\nif [[ -f \"$ENV_FILE\" ]]; then\ngrep -E \"^MUNIN_PROJECT=\" \"$ENV_FILE\" | while IFS=\"=\" read -r key val; do\nexport \"$key=$val\"\ndone\nfi\nexec npx @kalera/munin-claude mcp\n'\n```\n\n### 4. Start Using\n\n```bash\n# Talk to Munin directly\n@munion ask about the SePay integration\n@munion what did we decide about the auth system?\n\n# Or just start working — Munin auto-loads context\n# Munin will remember everything when you finish\n```\n\n---\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `MUNIN_PROJECT` | *(required)* | Your project ID from munin.kalera.app |\n| `MUNIN_BASE_URL` | `https://munin.kalera.dev` | Munin API server |\n| `MUNIN_API_KEY` | *(from dashboard)* | API key for authentication |\n\n### Self-hosted Munin\n\nIf you're running your own Munin instance:\n\n```bash\nMUNIN_BASE_URL=https://your-munin-instance.com \\\nclaude mcp add --scope user munin bash -c \\\n'MUNIN_BASE_URL=\"https://your-munin-instance.com\" exec npx @kalera/munin-claude mcp'\n```\n\n---\n\n## Skills — What Triggers Munin\n\nMunin activates automatically based on context:\n\n| Skill | Triggers | What It Does |\n|-------|----------|--------------|\n| `munin-memory` | \"search memory\", \"remember\", \"find in memory\" | Full memory operations |\n| `munin-architecture` | \"architecture\", \"tech stack\", \"system design\" | Architecture context |\n| `munin-error-catalog` | \"bug\", \"error\", \"crash\", \"doesn't work\" | Error resolution |\n\n---\n\n## Memory Protocol — How Munin Works\n\n### At Task Start\n1. `munin_search_memories` with keywords relevant to the task\n2. `munin_retrieve_memory` for detailed context\n3. Present findings — **verify from memory, don't guess**\n\n### At Task End\n`munin_store_memory` with:\n- **title**: Concise summary (max 80 chars)\n- **content**: Details including file paths, decisions, outcomes\n- **tags**: Categories (`task`, `architecture`, `bug-fix`, etc.)\n\n### On Bug Fixes\n1. Search error catalog first\n2. Present existing fix if found\n3. Fix and **store the new resolution**\n\n### On Decisions\nTag as `architecture` + `decision`, include timeline/version\n\n---\n\n## Pricing\n\n| Plan | Price | Memories | Projects |\n|------|-------|----------|----------|\n| **Free** | $0 | 500 | 3 |\n| Pro | $9/mo | Unlimited | Unlimited |\n| Team | $29/mo | Unlimited | Unlimited |\n\n**[Sign up at munin.kalera.app →](https://munin.kalera.app)**\n\n---\n\n## Resources\n\n| Resource | Link                                                                                           |\n|----------|------------------------------------------------------------------------------------------------|\n| 🌐 **Website** | [munin.kalera.app](https://munin.kalera.app)                                                   |\n| 📖 **Docs** | [munin.kalera.app/docs](https://munin.kalera.app/docs)                                         |\n| 💬 **Discord** | Coming soon                                                                                    |\n| 🐛 **Issues** | [github.com/3d-era/munin-for-agents/issues](https://github.com/3d-era/munin-for-agents/issues) |\n| 📦 **npm** | [npmjs.com/package/@kalera/munin-claude](https://npmjs.com/package/@kalera/munin-claude)       |\n| 🔌 **Gemini Extension** | [github.com/3d-era/munin-gemini-extension](https://github.com/3d-era/munin-gemini-extension)   |\n\n---\n\n## License\n\nMIT — [github.com/3d-era/munin-for-agents](https://github.com/3d-era/munin-for-agents)"}]}}