monomind

<p align="center" <img src="https://raw.githubusercontent.com/monoes/monomind/main/assets/banner.png" alt="Monomind" width="600" / </p

<h1 align="center"Monomind</h1

<p align="center" <strongAn open-source MCP server that extends Claude Code with a codebase knowledge graph, persistent memory, and multi-agent coordination.</strong<br/ MIT licensed &middot; Fully local &middot; No data leaves your machine </p

<p align="center" <a href="https://monoes.github.io/monomind/"<img src="https://img.shields.io/badge/docs-monoes.github.io%2Fmonomind-00D2AA?style=flat-square" alt="Docs" /</a <a href="https://www.npmjs.com/package/monomind"<img src="https://img.shields.io/npm/v/monomind?color=%2300D2AA&label=monomind&style=flat-square" alt="npm" /</a <a href="https://www.npmjs.com/package/monomind"<img src="https://img.shields.io/npm/dm/monomind?color=%2310B981&style=flat-square" alt="downloads" /</a <a href="https://github.com/monoes/monomind/stargazers"<img src="https://img.shields.io/github/stars/monoes/monomind?color=%23F59E0B&style=flat-square" alt="stars" /</a <a href="https://github.com/monoes/monomind/blob/main/LICENSE"<img src="https://img.shields.io/badge/license-MIT-%238B5CF6?style=flat-square" alt="license" /</a <a href="https://nodejs.org/"<img src="https://img.shields.io/badge/node-%3E%3D20-339933?style=flat-square&logo=node.js&logoColor=white" alt="node" /</a </p

<p align="center" <a href="https://monoes.github.io/monomind/#orgs"🏢 Orgs</a &nbsp;·&nbsp; <a href="https://monoes.github.io/monomind/#getting-started"🚀 Quickstart</a &nbsp;·&nbsp; <a href="https://monoes.github.io/monomind/#mastermind"⚡ Mastermind</a &nbsp;·&nbsp; <a href="https://monoes.github.io/monomind/#slash"📋 Commands</a &nbsp;·&nbsp; <a href="https://monoes.github.io/monomind/#architecture"🏗️ Architecture</a </p

---

What is Monomind?

Monomind is an open-source CLI and MCP server that plugs into Claude Code via the standard Model Context Protocol. It adds capabilities that Claude Code doesn't ship with out of the box:

• Codebase knowledge graph — tree-sitter parses your code into a SQLite-backed graph of files, functions, classes, and their relationships. Query imports, callers, and blast radius before making changes.
• Persistent memory — a JSON pattern store with episodic recall that survives across sessions. Agents and orgs share context without re-prompting.
• Multi-agent coordination — in-session, spawn ad-hoc agent teams via Claude Code's Task tool; for persistent background work, monomind org run starts a real SDK-backed daemon with policy-gated role agents and a live dashboard.
• Reusable slash commands — 30+ development workflows (build, review, debug, TDD, architecture) available as /mastermind: commands inside Claude Code.

npm install -g monomind        # MIT licensed, runs entirely on your machine
cd your-project && monomind init
claude mcp add monomind -- npx -y monomind@latest mcp start

Trust & Security

| Concern | Answer | |---|---| | License | MIT — use it however you want | | Data privacy | Everything runs locally — your code and memory store never leave your machine. The one exception: crash reporting is on by default (monomind crash-reporting disable to opt out) — a hard crash in monomind/mono-agent/monotask/mono-clip files a GitHub issue on that tool's own repo via the GitHub API. That's the only network call Monomind itself makes; it never phones a monoes-controlled server. | | Dependencies | Standard npm packages (tree-sitter, better-sqlite3, sql.js, zod). tree-sitter and better-sqlite3 are native (prebuilt) Node addons, not pure JS/WASM — sql.js is WASM. No post-install scripts that download code. | | Permissions | Registers as an MCP server — Claude Code controls what tools are available and prompts you before executing anything sensitive. | | Source | Fully open. Read every line at github.com/monoes/monomind. | | Maintenance | Active development, regular releases on npm. |

---

🏢 Autonomous Organizations

This is the headline feature. monomind org run starts a persistent, SDK-backed daemon that runs an autonomous agent organization — roles, hierarchy, policy-gated tool access, a live dashboard — until you stop it.

The idea

Every business function needs a team. Define the org once as a JSON file — goal, roles, who reports to whom, per-role tool/file/budget policy — then run it as a real background daemon backed by the Claude Agent SDK. It persists across sessions, streams live into the dashboard Claude Code auto-starts for the project, and can discover and message other Monomind orgs running on the same machine.

flowchart TD
    U(["You"])
    DEF["org.json\nGoal + roles + policy"]
    RUN["monomind org run\nStart SDK daemon"]
    BOSS["Boss Agent\nAgent SDK session"]
    W["Writer"]
    S["SEO Specialist"]
    R["Reviewer"]
    DASH[("Dashboard\n:4242\nauto-started by\nClaude Code hook")]
    XORG[("Other orgs\ncross-process")]

    U --> DEF --> RUN --> BOSS