Every AI model has blind spots. Claude Octopus supports ten external provider integrations — Codex, Antigravity CLI, Copilot, Qwen, Ollama, Perplexity, OpenRouter, OrcaRouter, OpenCode, and Grok — alongside the built-in Claude Code host, with consensus gates that flag disagreements before you ship.
Claude Code v2.1.14+ is the minimum supported runtime; the plugin tracks 182 Claude Code capability flags through Claude Code v2.1.219.
One line: one /octo command, and multiple AI models (Codex, Antigravity, Copilot, Qwen, Ollama, OpenRouter, Grok, …) research, build, review and debate together — with a consensus gate before delivery.
A port of nyldn/claude-octopus (MIT, v9.64.0) to
DeepSeek Harness. The upstream orchestration
engine (scripts/orchestrate.sh and every skill/command/agent/hook) is kept byte-identical;
only the dsh plugin seams are adapted.
> /octo research "GraphQL vs REST design trade-offs"
🐙 Octopus Research
probe codex → parallel exploration (multiple providers)
probe agy → one independent perspective per provider
probe claude → ...
consensus gate 75% → disagreements listed explicitly
→ structured research report (summary / themes / takeaways / sources)
What's New
🆕 v9.64.0 — Keep Octopus dormant until explicitly invoked.
Default roster: Claude Opus 5 leads architecture, planning, security reasoning, and final judgment; GPT-5.6 Sol is the independent implementation/review peer; Claude Sonnet 5 is the standard Claude seat; Fable 5 remains an opt-in judgment escalation. Existing model pins and provider configuration still win. See the routing strategy.
Version
Best Features
v9.64.0 (new)
Keep Octopus dormant until explicitly invoked.
v9.50
Claude Code 2026 compatibility layer — routines manifest, SubagentStop gate, /octo:usage cost attribution, Claude Agent SDK seat.
v9
Up to 10 external provider integrations, structured provider debates, configurable multi-LLM councils.
Current fresh configurations use GPT-5.6 Sol for Codex implementation/review, Claude Opus 5 for premium Claude work, and Claude Sonnet 5 for the standard Claude seat. Existing environment, session, and providers.json pins remain unchanged; OCTOPUS_LEGACY_ROLES=1 restores the pre-frontier role mapping.
Premium Claude role routing (architect, strategist, security-reviewer to Opus) landed in v9.29; restore the older mapping with OCTOPUS_LEGACY_ROLES=1.
Claude Code Web and Remote Sessions
When an explicit Octopus workflow is running in a hosted, web, or remote-control
environment, set OCTOPUS_REMOTE_SESSION=true in that environment. Once a
workflow starts, orchestrate.sh also recognizes CLAUDE_CODE_REMOTE=true or
CLAUDE_CODE_WEB=true and applies unattended-safe runtime defaults: autonomy is
set to autonomous, provider smoke tests are skipped, and the statusline uses a
lightweight remote-safe display.
Quickstart
dsh plugin --profile add github:GongYuanCaiJi/dsh-claude-octopus
# then, inside a dsh session:
/octo research "topic"
Four providers cost nothing extra when you already have access: 🧭 Antigravity CLI (agy),
Codex, and Copilot use existing subscriptions or local auth; Ollama runs locally for free.
Zero external providers works too — the host is a seat.
54 Commands That Matter Most
The full surface is scripts/orchestrate.sh (all subcommands under /octo help). The
workflows that matter most:
/octo research "topic" # multi-provider parallel research
/octo develop "task" # implementation with validation
/octo embrace "spec" # full four-phase workflow
/octo council --goal decision "?" # 3/5/7-persona structured deliberation
/octo debate "question" # multi-model debate
/octo doctor # environment diagnostics
How It Works
Octopus stays dormant until you explicitly run /octo:*. Each command dispatches through
the upstream scripts/orchestrate.sh engine, which probes the configured provider CLIs
with role-specific personas, applies quality gates between the Discover → Define →
Develop → Deliver phases, and synthesizes a consensus result. In dsh, the single-agent
probe is exposed as the octopus provider in ctx.subagents.
Provider
Integration
Codex
codex CLI
Antigravity
agy CLI
Copilot
GitHub Copilot CLI
Qwen
Qwen Code CLI
Ollama
local
Perplexity
API key
OpenRouter
API key
OrcaRouter
API key
OpenCode
OpenCode CLI
Grok
xAI API key
Cost & Provider Pricing
Four providers cost nothing extra when you already have access: 🧭 Antigravity CLI (agy),
Codex, and Copilot use existing subscriptions or local auth; Ollama runs locally for free.
Qwen now requires API-key or Coding-Plan auth.
The prepare script builds dist/ during installation. If pnpm blocks the build
step, add this package to allowBuilds in the profile's pnpm-workspace.yaml.
Not published to npm yet, so no bare-name install.
🚀 Usage
/octo help # all subcommands
/octo research "topic" # multi-provider parallel research
/octo develop "task" # implementation with validation
/octo council --goal decision "?" # 3/5/7-persona structured deliberation
/octo debate "question" # multi-model debate
/octo embrace "spec" # full four-phase workflow
/octo doctor # environment diagnostics
Install external provider CLIs (codex, agy, qwen …) as needed; /octo doctor shows
what's missing.
Port notes (vs upstream nyldn/claude-octopus@5d7ac6b6)
Kept verbatim: 1169 of the upstream tree's 1174 files — scripts/, commands/,
skills/, agents/, hooks/, config/, docs/, mcp-server/, openclaw/ —
byte-identical (README.md/package.json/LICENSE/.gitignore are the port's own
replacements; tests/unit/test-github-work-queue-hook.sh is a documented adaptation),
verifiable with cmp (THIRD_PARTY_NOTICES.md pins the
upstream commit and per-file SHA-256).
Added (no upstream counterpart): the dsh seam layer —
src/shell.ts (ctx.shell adapter with explicit truncated/timedOut/sandbox.denied/
invocation.signal handling), src/commands.ts (/octo → scripts/orchestrate.sh),
src/subagents.ts (registers the octopus provider into ctx.subagents, wiring
dsh's built-in subagent dispatch to the upstream probe-single engine), and the
package.json / cordis.patch.yml plugin mounting.
Known limitation: upstream copy is English — it is the upstream original, kept
untranslated.
🛠 Development
npm install # runs prepare, produces dist/
npm test # build + adapter unit tests + full upstream suite (smoke + unit)
The upstream suite includes cases that commit directly to main inside disposable
temp repos; if your machine has a "no direct main commits" git hook, npm test
scopes safetyfuse.allowStable to the test process via GIT_CONFIG_COUNT without
touching any repository config.
