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

`bash
npx create-merlin-brain
`

What You Get

$3

| 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 |

$3

- 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

$3

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:
`bash
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