Claude Octopus exposes multi-LLM orchestration with ten external providers, integrated workflows, and a Claude-native core. It supports up to ten external providers, integrates with Claude Code, and offers multi-LLM councils and four-phase workflows.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Claude Octopus is a tool that supports multiple AI provider integrations (ten external providers alongside a Claude Code host) to run structured, multi-LLM workflows with consensus gates and predefined task phases. It emphasizes escalation from Claude-native paths to Octopus when multiple model opinions or stricter reviews are needed.
How it works
It coordinates workflows across multiple providers, enabling debates and council-style deliberations, with gates between Discover → Define → Develop → Deliver. It includes a smart router and provider-aware prompts, and supports per-task routing and model configurations. It also provides a built-in set of commands and a four-phase methodology to manage tasks.
Getting started
Quickstart
# Terminal (not inside a Claude Code session):
claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install octo@nyldn-plugins
# Then inside Claude Code:
/octo:setup
Claude Code v2.1.14+ is the minimum supported runtime. The current plugin tracks 182 Claude Code capability flags through Claude Code v2.1.219.
Install options
# Install for Codex CLI
git clone --depth 1 https://github.com/nyldn/claude-octopus.git ~/.codex/claude-octopus && mkdir -p ~/.agents/skills && ln -sf ~/.codex/claude-octopus/skills ~/.agents/skills/claude-octopus
Additional install methods
- OpenCode: clone to ~/.opencode/claude-octopus and link skills to ~.
- Cursor/OpenCode related MCP server details are provided in the README sections.
Recent releases
Latest release notes (examples):
- v9.59.0 (2026-08-04): Added literal provider-model routing, reliability fixes.
- v9.58.0 (2026-08-02): Agent topology audit, four adapted workflow skills, Gemini migration as a real choice.
- v9.57.0 (2026-08-02): Command Code provider, selective Fable 5 escalation, progressive feature disclosure.
- v9.56.1 (2026-07-27): Destructive-delete guards for recursive options.
- v9.56.0 (2026-07-27):
/octopusissue-comment workflow now requires a trusted author.
Traction
Stars: 3924 Forks: 367 Open issues: 10
Behind the repo
Not provided in the excerpt beyond project description and release notes.
Caveats
License: MIT Created: 2026-01-15 Last push: 2026-08-04 Language: Shell
Notes: The README mentions multiple environment variables and release-specific defaults, including Claude Code compatibility requirements and provider API keys for cloud setups.