Skip to main content

Three brains, one workflow

Multi-AI orchestration framework that coordinates Claude, Codex, and Gemini with structured workflows, 33+ specialized personas, and adversarial quality gates. Built for Claude Code.

🐙

Quick start

Get Claude Octopus running in minutes

1

Install the plugin

Install Claude Octopus from Claude Code’s plugin marketplace:
/plugin marketplace add https://github.com/nyldn/claude-octopus.git
/plugin install claude-octopus@nyldn-plugins
2

Run setup

Configure your AI providers and check system status:
/octo:setup
Claude Octopus works with just Claude built-in. Add Codex or Gemini for multi-AI orchestration features.
3

Run your first workflow

Try the embrace command to run a full 4-phase workflow:
/octo:embrace research authentication patterns
The framework will guide you through discover, define, develop, and deliver phases with quality gates between each.

Explore by feature

Dive into the capabilities that make Claude Octopus powerful

Double Diamond Workflow

Four structured phases (discover, define, develop, deliver) with quality gates between each stage

Multi-AI Orchestration

Coordinate Claude, Codex, and Gemini with distinct roles and 75% consensus gates

33+ Specialized Personas

Expert agents from backend-architect to security-auditor that activate based on your task

46+ Commands

From /octo:embrace for full workflows to /octo:debug for targeted troubleshooting

Dark Factory Mode

Autonomous spec-to-software pipeline with holdout testing and satisfaction scoring

OpenClaw Integration

MCP server exposes Octopus workflows to messaging platforms and external clients

Core concepts

Understand how Claude Octopus orchestrates multi-AI workflows

Architecture

How the orchestration framework coordinates multiple AI providers

Workflows

Structured phases with quality gates and adversarial review

Personas

Specialized agents with distinct roles and expertise

Resources

Additional help and community

GitHub Repository

View source code, report issues, and contribute to the project

Troubleshooting

Common issues and debugging techniques

Ready to orchestrate?

Install Claude Octopus and start coordinating multiple AI providers with structured workflows, quality gates, and specialized personas.

Get Started