# dual-orchestrator

dual-orchestrator routes work between interactive Claude Code and headless Codex: use one for reasoning and review, the other for parallel execution. Built for workflows that combine both.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/dual-mode/dual-orchestrator.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/dual-orchestrator

## What it does

The subagent chooses a platform based on the task. Requests about architecture, debugging, and code review go to Claude Code; implementation, tests, documentation, and batch jobs go to Codex. Routing relies on wording patterns, so the prompt affects the choice.

A hybrid workflow can start with an architecture discussion in Claude Code, move into parallel implementation with Codex, then return to Claude Code for review. The setup also describes swarm coordination and shared memory for design decisions and worker results.

The examples launch background work with `claude -p` and retrieve results with `npx claude-flow@v3alpha memory list --namespace results`. Parallel Codex workflows therefore depend on those commands and the `claude-flow` integration; check them before using that flow.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/dual-orchestrator.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/dual-orchestrator.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/dual-orchestrator.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/dual-mode/dual-orchestrator.md

## When to use it
- split design and implementation across platforms
- delegate several tasks for parallel execution
- route debugging and code review to an interactive session
- gather background task results for review

## Example prompts
- Plan the architecture for this feature, then assign the implementation to Codex as parallel tasks.
- Investigate this bug in the existing code and explain where it originates.
- Generate tests and documentation for this feature in background tasks, then bring the results back for review.

## Similar
- [Swarm Orchestration](https://affpapa.org/en/nevibecode/skills/swarm-orchestration.md) — skill · 2100 installs
- [do-in-parallel](https://affpapa.org/en/nevibecode/skills/do-in-parallel.md) — skill · 1300 installs
- [dual-axis-skill-reviewer](https://affpapa.org/en/nevibecode/skills/dual-axis-skill-reviewer.md) — skill · 3600 installs
- [multi-agent-coordinator](https://affpapa.org/en/nevibecode/agents/rohitg00-multi-agent-coordinator.md) — subagent · ★ 2858 repo stars
- [orchestrator](https://affpapa.org/en/nevibecode/agents/rohit-ghumare-orchestrator.md) — subagent · ★ 2966 repo stars
- [gem-orchestrator](https://affpapa.org/en/nevibecode/agents/gem-orchestrator.md) — subagent · ★ 41430 repo stars

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
