Skip to content

fix(codex): split dual-mode claude and codex executors #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
GoldenCoreOne wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix(codex): split dual-mode claude and codex executors #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 20 additions & 49 deletions v3/@claude-flow/codex/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -497,14 +497,6 @@ $performance-optimization
| Post-Task | `$hooks:post-task` | Record task completion |
| Session End | `$hooks:session-end` | End session and persist |

#### Dual-Mode Skills (NEW)

| Skill | Syntax | Description |
|-------|--------|-------------|
| Dual Spawn | `$dual-spawn` | Spawn parallel Codex workers from Claude Code |
| Dual Coordinate | `$dual-coordinate` | Coordinate Claude Code + Codex execution |
| Dual Collect | `$dual-collect` | Collect results from parallel Codex instances |

### Custom Skills

Create custom skills in `.agents/skills/`:
Expand Down Expand Up @@ -559,56 +551,32 @@ npx claude-flow@alpha init --dual

### Spawning Parallel Codex Workers

From Claude Code, spawn headless Codex instances:
From Claude Code, spawn headless Codex instances with `codex exec`.
Use `claude -p` only for Claude workers.

```bash
# Spawn workers in parallel (each runs independently)
claude -p "Analyze src/auth/ for security issues" --session-id "task-1" &
claude -p "Write unit tests for src/api/" --session-id "task-2" &
claude -p "Optimize database queries in src/db/" --session-id "task-3" &
# Spawn Codex workers in parallel (each runs independently)
codex exec --skip-git-repo-check "Analyze src/auth/ for security issues" &
codex exec --skip-git-repo-check "Write unit tests for src/api/" &
codex exec --skip-git-repo-check "Optimize database queries in src/db/" &
wait # Wait for all to complete
```

### Dual-Mode Skills

| Skill | Platform | Description |
|-------|----------|-------------|
| `$dual-spawn` | Codex | Spawn parallel workers from orchestrator |
| `$dual-coordinate` | Both | Coordinate cross-platform execution |
| `$dual-collect` | Claude Code | Collect results from Codex workers |

### Dual-Mode Agents
### What Dual-Mode Currently Provides

| Agent | Type | Execution |
|-------|------|-----------|
| `codex-worker` | Worker | Headless background execution |
| `codex-coordinator` | Coordinator | Manage parallel worker pool |
| `dual-orchestrator` | Orchestrator | Route tasks to appropriate platform |
The current implementation provides:

### Task Routing Rules
- Static collaboration templates for `feature`, `security`, and `refactor`
- Fixed platform assignment per template worker
- Shared memory initialization and result collection
- Best-effort parallel execution within each dependency level, capped by `maxConcurrent`

| Task Complexity | Platform | Reason |
|----------------|----------|--------|
| Simple (1-2 files) | Codex Headless | Fast, parallel |
| Medium (3-5 files) | Claude Code | Needs context |
| Complex (architecture) | Claude Code | Reasoning required |
| Bulk operations | Codex Workers | Parallelize |
| Final review | Claude Code | Integration |
It does not currently provide:

### Example Workflow

```
1. Claude Code receives complex feature request
2. Designs architecture and creates plan
3. Spawns 4 Codex workers:
- Worker 1: Implement data models
- Worker 2: Create API endpoints
- Worker 3: Write unit tests
- Worker 4: Generate documentation
4. Workers execute in parallel (headless)
5. Claude Code collects and integrates results
6. Final review and refinement in Claude Code
```
- Dynamic task routing by complexity
- Built-in dual-mode skills such as `$dual-spawn`
- Dedicated coordinator agents beyond the configured worker list
- Automatic Claude-side collection workflows outside the orchestrator itself

### Memory Sharing

Expand Down Expand Up @@ -674,6 +642,8 @@ const orchestrator = new DualModeOrchestrator({
timeout: 300000,
});

// maxConcurrent limits workers within the same dependency level.

// Listen to events
orchestrator.on('worker:started', ({ id, role }) => console.log(`Started: ${role}`));
orchestrator.on('worker:completed', ({ id }) => console.log(`Completed: ${id}`));
Expand Down Expand Up @@ -1022,3 +992,4 @@ MIT

- Documentation: https://github.com/ruvnet/claude-flow
- Issues: https://github.com/ruvnet/claude-flow/issues

Loading