Monomind

Build. Learn. Evolve. Without stopping.

The self-learning orchestration layer that turns Claude Code
into an autonomous, multi-agent engineering team.

📖 Full Docs  •  Quickstart  •  What It Does  •  Features  •  Commands  •  Memory

What is Monomind?

You already use Claude Code. Monomind makes it autonomous.

Type one command. Walk away. Come back to a clean codebase.

/mastermind:autodev --tillend --focus security

Monomind researches your project, selects the highest-impact improvement, builds it with a coordinated agent chain, reviews until zero findings — then repeats. Indefinitely. Until there's nothing left to fix.

Without Monomind: You prompt Claude, wait, review, iterate.
With Monomind: You set a direction. Monomind executes.

Quickstart

# Install
npm install -g monomind

# Initialize in your project
cd your-project
monomind init

# Wire into Claude Code
claude mcp add monomind npx monomind mcp start

# Start the background daemon
monomind daemon start

That's it. Open Claude Code and start orchestrating.

→ Full setup guide

What Monomind Does

Autonomous Build Loop — /mastermind:autodev

The flagship command. Research → Build → Review → Repeat.

Phase 1  Research     Parallel scan: git log, file analysis, TODO/FIXME grep,
                      monograph god nodes, memory search for prior work.
                      Returns ranked list of 3-5 improvement candidates.

Phase 2  Selection    Picks by feasibility × blast radius × focus alignment.
                      Stores selection to memory. Avoids repeating past work.

Phase 3  Build        Spawns architect → coder → tester → reviewer chain.
                      Runs with concrete spec and acceptance criteria.

Phase 4  Review Loop  Code Reviewer + Security Engineer + Reality Checker
                      run in parallel. Auto-fixes. Repeats up to 5× until clean.

Phase 5  Log          Records completion. Continues to next improvement.
                      --tillend schedules the next session automatically.

/mastermind:autodev                     # 1 improvement
/mastermind:autodev 5                   # 5 improvements in sequence
/mastermind:autodev --tillend           # run until nothing is left
/mastermind:autodev --focus security    # bias toward security work
/mastermind:autodev --focus dx          # bias toward developer experience
/mastermind:autodev --newfeature 3      # discover & fully deliver 3 brand-new features
                                        # (build → review → document → stage each one)

From Prompt to Coordinated Execution

You: "Add webhook delivery with retries and a dead-letter queue"

Monomind:
  1. Software Architect   → designs the system
  2. backend-dev          → implements webhook dispatcher
  3. backend-dev          → implements retry logic with exponential backoff
  4. Database Optimizer   → designs dead-letter queue schema
  5. tester               → writes integration tests
  6. Code Reviewer        → reviews all changes before merge

→ See all 10 pages of documentation

Features

230+ Specialized Agents

Not generic assistants — domain experts with targeted system prompts, each optimized for a specific class of work.

Swarm Topologies

Coordinate multiple agents working in parallel on the same problem:

Consensus algorithms: Raft (leader-based), Byzantine (fault-tolerant up to f < n/3), Gossip (eventually consistent), CRDT (conflict-free), Quorum (majority vote).

/mastermind          # topology picker — recommends the best option for your task
monomind swarm init --topology hierarchical --agents 8 --strategy specialized

Self-Learning Memory — The Memory Palace

Every interaction makes Monomind smarter:

• Pure-JS HNSW semantic search via AgentDB indexing
• Hybrid backend — SQLite for structured data + AgentDB for semantic
• BM25 + vector hybrid retrieval — precision + recall
• Session continuity — pick up exactly where you left off

Knowledge Graph — Monograph

30 graph tools that build a full dependency map of your codebase:

monograph_suggest "add webhook retry logic"  # → ranked relevant files
monograph_query "UserService dependencies"   # → file paths + line numbers
monograph_god_nodes                          # → high-centrality files
monograph_impact "auth.ts"                   # → blast radius before changing

Queried automatically before every task. No manual invocation needed.

Keyword Routing & Outcome Measurement

Monomind routes tasks deterministically and measures whether the routing helped:

• Keyword routing — createKeywordRouter maps tasks to handlers without an LLM call
• Route-outcome correlation — recommended routes are auto-correlated with actual outcomes; doctor surfaces routing accuracy and recommended-vs-actual adherence
• Trajectory + outcome logging — steps, trajectories, and command results are recorded for later analysis

The full neural learning loop (SONA modes, LoRA, EWC++, Reasoning Bank) lives on the monoes-full-loop branch.

3-Tier Model Routing

Monomind routes every task to the cheapest model that can handle it:

29+ Hooks + 12 Background Workers

Monomind hooks into every phase of your Claude Code workflow:

Background workers (12 total): ultralearn, optimize, consolidate, predict, audit, map, preload, deepdive, document, refactor, benchmark, testgaps — all autonomous.

Live Dashboard

Real-time visibility into every project, session, agent, memory operation, route decision, and token spend.

monomind daemon start    # starts background workers and session tracking

Sessions are fully recorded and replayable — full conversation replay with tool breakdown, agent spawns, and memory operations.

Commands

53+ CLI Commands

monomind init                              # Project initialization wizard
monomind agent spawn --type coder          # Spawn a specific agent
monomind swarm init --topology mesh        # Initialize a swarm
monomind memory search "auth patterns"     # Search vector memory
monomind hooks route --task "fix bug"      # Route to best agent
monomind neural status                      # Inspect pattern-learning status
monomind doctor --fix                      # Diagnose and auto-fix issues
monomind daemon start                      # Start background workers

→ Full CLI reference

160+ Slash Commands (inside Claude Code)

→ Full slash command reference

--tillend — Fully Autonomous Loops

Any command can run autonomously until there's nothing left to do:

/mastermind:autodev --tillend --focus security
# → runs until every security issue is found and fixed

/mastermind:review --tillend --auto
# → reviews and fixes until zero findings

/mastermind:autodev 5 --tillend --maxruns 20
# → 5 improvements per session, up to 20 sessions

The loop uses ScheduleWakeup to resume across sessions. A staleness guard prevents duplicate runs. Human-in-loop items pause and wait for your response before continuing.

# Stop a loop at any time
touch .monomind/loops/{loop-id}.stop

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                           Monomind                              │
├─────────────────┬───────────────┬──────────────┬───────────────┤
│  230+ Agents    │  Swarm Engine  │ Memory Palace │  Intelligence │
│                 │               │              │               │
│  Specialized    │  6 topologies  │ AgentDB HNSW │  Keyword      │
│  agent defs     │  5 consensus   │ Knowledge    │  routing +    │
│  + 3-tier       │  algorithms    │ Graph        │  outcome      │
│  routing        │               │ (Monograph)  │  measurement  │
├─────────────────┴───────────────┴──────────────┴───────────────┤
│                   29+ Hooks + 12 Background Workers             │
├─────────────────────────────────────────────────────────────────┤
│                  MCP Server (stdio / http / WebSocket)          │
├─────────────────────────────────────────────────────────────────┤
│                        Claude Code Runtime                      │
└─────────────────────────────────────────────────────────────────┘

Key Packages

The workspace ships 16 @monomind/* packages:

Performance

Who Uses Monomind?

• Solo developers — the power of a full engineering team from one terminal
• Startups — ship features 10x faster with autonomous agent pipelines
• Enterprise teams — coordinate complex multi-module changes without drift
• Security teams — automate audit, CVE triage, and compliance workflows
• Game studios — Unity, Unreal, Godot, and Roblox specialists on demand
• Marketing teams — content operations with 27 domain-specific marketing agents

Documentation

Full interactive documentation: monoes.github.io/monomind

Contributing

git clone https://github.com/nokhodian/monomind.git
cd monomind
pnpm install
monomind doctor --fix

See CONTRIBUTING.md for guidelines.

License

MIT — See LICENSE for details.

Stop prompting. Start orchestrating.

📖 Docs  •  npm  •  GitHub  •  Issues

Acknowledgements

Monomind builds on ideas, patterns, and research from the following projects:

Research Acknowledgements

Monomind implements techniques from peer-reviewed research across distributed systems, machine learning, and software engineering: