Merlin - The Ultimate AI Brain for Claude Code

  ███╗   ███╗███████╗██████╗ ██╗     ██╗███╗   ██╗
  ████╗ ████║██╔════╝██╔══██╗██║     ██║████╗  ██║
  ██╔████╔██║█████╗  ██████╔╝██║     ██║██╔██╗ ██║
  ██║╚██╔╝██║██╔══╝  ██╔══██╗██║     ██║██║╚██╗██║
  ██║ ╚═╝ ██║███████╗██║  ██║███████╗██║██║ ╚████║
  ╚═╝     ╚═╝╚══════╝╚═╝  ╚═╝╚══════╝╚═╝╚═╝  ╚═══╝

Merlin is a complete AI-powered development system for Claude Code with three integrated layers:

• Merlin Sights - Knowledge layer (instant codebase context)
• Merlin Workflows - Planning & execution (/merlin:* commands)
• Merlin Agents - Specialist agents for every task

Quick Install

npx create-merlin-brain

What You Get

Workflows (/merlin:* commands)

| Command | Description | |---------|-------------| | /merlin:help | See all available commands | | /merlin:map-codebase | Analyze and document your codebase | | /merlin:new-project | Initialize project planning | | /merlin:create-roadmap | Create implementation phases | | /merlin:plan-phase | Create detailed execution plans | | /merlin:execute-phase | Execute plans with parallel agents | | /merlin:verify-work | Validate built features |

Agents

• merlin-executor - Executes plans with atomic commits
• merlin-codebase-mapper - Analyzes and documents codebases
• merlin-verifier - Validates phase completion
• merlin-researcher - Conducts systematic research
• product-spec - Turns ideas into specs
• system-architect - Designs simple architecture
• implementation-dev - Implements features
• hardening-guard - Security and error handling
• dry-refactor - Keeps code DRY and organized
• tests-qa - Designs and implements tests
• docs-keeper - Maintains documentation

Merlin Sights (Optional Enhancement)

Merlin Sights provides instant codebase context across sessions. Get your API key at merlin.build.

With Sights: Instant context, cross-session memory, duplicate prevention Without Sights: Full workflows still work, uses file exploration

How It Works

┌──────────────────────────────────────────────────────────────┐
│                      MERLIN                                  │
│                                                              │
│  ┌────────────────────────────────────────────────────────┐ │
│  │  MERLIN SIGHTS (Optional)                              │ │
│  │  Instant context • Cross-session memory                │ │
│  │  Falls back to file exploration if unavailable         │ │
│  └────────────────────────────────────────────────────────┘ │
│                           ↓                                  │
│  ┌────────────────────────────────────────────────────────┐ │
│  │  MERLIN WORKFLOWS                                      │ │
│  │  /merlin:map-codebase • /merlin:plan-phase • etc.      │ │
│  └────────────────────────────────────────────────────────┘ │
│                           ↓                                  │
│  ┌────────────────────────────────────────────────────────┐ │
│  │  MERLIN AGENTS                                         │ │
│  │  Parallel execution • Wave-based • Checkpoints         │ │
│  └────────────────────────────────────────────────────────┘ │
│                                                              │
└──────────────────────────────────────────────────────────────┘

Getting Started

1. Install Merlin:

   npx create-merlin-brain

2. Open Claude Code in any project

3. Run your first command:

   /merlin:map-codebase

4. Start planning:

   /merlin:new-project

Documentation

Visit merlin.build/docs for full documentation.

License

MIT