by nyldn
Surface AI blindspots before you ship. Put up to 8 AI models on every research, design or coding task.
# Add to your Claude Code skills
git clone https://github.com/nyldn/claude-octopusGuides for using ai agents skills like claude-octopus.
Last scanned: 4/22/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-04-22T06:02:06.988Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}claude-octopus is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by nyldn. Surface AI blindspots before you ship. Put up to 8 AI models on every research, design or coding task. It has 3,924 GitHub stars.
Yes. claude-octopus passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/nyldn/claude-octopus" and add it to your Claude Code skills directory (see the Installation section above).
claude-octopus is primarily written in Shell. It is open-source under nyldn on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh claude-octopus against similar tools.
No comments yet. Be the first to share your thoughts!
Every AI model has blind spots. Claude Octopus supports ten external provider integrations — Codex, Gemini, Antigravity CLI, Copilot, Qwen, Ollama, Perplexity, OpenRouter, OpenCode, and Grok — alongside the built-in Claude Code host, with consensus gates that flag disagreements before you ship.
Claude-native first, Octopus for escalation. Use Claude-native /init, /review, and /security-review when Claude is enough. Use Octopus when you want multiple model opinions, adversarial review, or stricter multi-LLM workflows.
🐙 Research, build, review, and ship — with ten external providers checking the host's work. Say what you need, and the right workflow runs. Claude-native handles the ordinary path; Octopus handles the escalated path. A 75% consensus gate catches disagreements before they reach production. No single model's blind spots slip through.
🧠 Remembers across sessions. Integrates with claude-mem and agentmemory for persistent memory — past decisions, research, and context survive session boundaries.
⚡ Spec in, software out. Dark Factory mode takes a spec and autonomously runs the full pipeline — research, define, develop, deliver. You review the output, not every step.
🔄 Four-phase methodology, not just tools. Every task moves through Discover → Define → Develop → Deliver, with quality gates between phases. Other orchestrators give you infrastructure. Octopus gives you the workflows.
🐙 32 specialized personas (role-specific AI agents like security-auditor, backend-architect), 50 commands (slash commands you type), 63 skills (reusable workflow modules). Say "audit my API" and the right expert activates. Don't know the command? The smart router figures it out.
🐙 Works with just Claude. Adds up to ten external provider integrations. Zero external providers are needed to start. Add them one at a time — each activates automatically when detected.
💰 Five providers cost nothing extra when you already have access. Codex, Gemini, Antigravity CLI, and Copilot use existing subscriptions or local auth. Ollama runs locally for free. Qwen now requires API-key or Coding-Plan auth; its free OAuth tier ended on 2026-04-15.
🆕 v9.58.0 — Agent topology audit, four adapted workflow skills, and the Gemini migration offered as a real choice.
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.
/octo:model-config # inspect or override the frontier roster OCTOPUS_OPUS5_AUTO_XHIGH=1 # opt in to automatic xhigh Opus 5 phases OCTOPUS_OPUS_MODEL=claude-fable-5 # explicitly opt in to Fable 5
🆕 v9.41 — Multi-LLM Council.
/octo:councilruns a structured 3/5/7-persona deliberation across Claude, Codex, Gemini, and OpenCode with goal modes (advice,decision,plan,implement,review), styles (balanced,adversarial,red-team,executive,implementation), benchmark-aware role routing, quorum + critical-veto gates, budget caps, and gated worktree handoff for approved plans. Use it when one model's opinion isn't enough./octo:council --goal decision --style adversarial "Should this service stay monolithic?" /octo:council --goal implement --implement plan-only "Refactor the auth flow"
| Version | Best Features |
|---|---|
| v9.58.0 (new) | Agent topology audit, four adapted workflow skills, and the Gemini migration offered as a real choice. |
| v9.50 | Claude Code 2026 compatibility layer — routines manifest (schedule + GitHub-event automations), SubagentStop quality/cost gate, /octo:usage cost attribution, worktree.bgIsolation opt-out, Claude Agent SDK seat (introduced with Opus 4.8 and now following the current Opus 5 default), starter skills pack, /plugin browse manifest with projected context cost. |
| v9.41 | /octo:council promoted to first-class workflow — structured multi-LLM deliberation with goal modes, adversarial/red-team styles, benchmark-aware persona routing, quorum and critical-veto gates, budget preflight, and gated worktree handoff for approved implementation plans. |
| v9 (current) | Up to 10 external provider integrations (Codex, Gemini, Antigravity CLI, Copilot, Qwen, Ollama, Perplexity, OpenRouter, OpenCode, and Grok) alongside the Claude Code host. Structured provider debates and configurable multi-LLM councils. Smart router — just say what you need. Agent summary tables show which providers actually contributed. Provider-aware prompt preflight prevents silent oversize failures. Research breadth modes fan out light, standard, or exhaustive investigations. Setup aliases and fuzzy /octo:* corrections reduce command friction. Discipline mode with 8 auto-invoke gates. Two-stage review. Circuit breakers with automatic provider recovery. Cursor + OpenCode + Codex cross-compatibility. Token compression: bin/octo-compress pipe + auto PostToolUse hook save ~7,300 tokens/session. PostCompact context recovery. bin/octopus CLI. 182 Claude Code capability flags through v2.1.219, including Opus 5, Sonnet 5, and dynamic workflow awareness. |
| v8 | Multi-LLM code review with inline PR comments. Parallel workstreams in isolated git worktrees. Reaction engine — auto-responds to CI failures. 32 specialized personas. Dark Factory autonomous pipeline. |
| v7 | Double Diamond workflow. Multi-provider dispatch. Quality gates and consensus scoring. Configurable sandbox modes. |
providers.json pins remain unchanged; OCTOPUS_LEGACY_ROLES=1 restores the pre-frontier role mapping.CLAUDE_SDK_API_KEY, OCTOPUS_CLAUDE_SDK_MODEL, OCTOPUS_CLAUDE_SDK_MAX_TOKENS, OCTOPUS_CLAUDE_SDK_ALLOWED_MODELS, OCTOPUS_CLAUDE_SDK_CONTEXT_BUDGET.OCTOPUS_FABLE5_MODE (auto/off/on), OCTOPUS_FABLE5_NO_RETRY. Guards auto-enable only when you pin claude-fable-5.OCTOPUS_LEGACY_ROLES=1.# 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
That's it. Setup detects installed providers, shows what's missing, and walks you through configuration. You need zero external providers to start — Claude is built in.
Claude Code v2.1.14+ is the minimum supported runtime. Newer Claude Code releases unlock additional Octopus diagnostics and release checks automatically; the current plugin tracks 182 Claude Code capability flags through Claude Code v2.1.219.
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
Restart Codex. Skills appear automatically — invoke with $skill-doctor, $skill-debug, etc.
Cursor uses Octopus as an MCP server (not a plugin — Cursor doesn't have Claude Code's plugin system). You get MCP tools like octopus_discover, octopus_review, etc. instead of /octo:* slash commands.
Important: Just cloning the repo is not enough. You must complete all three steps below — install dependencies and configure the MCP server — for Cursor to pick up Octopus tools.
# 1. Clone the repo
git clone --depth 1 https://github.com/nyldn/claude-octopus.git ~/.cursor/claude-octopus
# 2. Install MCP server dependencies
cd ~/.cursor/claude-octopus/mcp-server && npm ins