AI Duo Orchestrator

AI Duo Orchestrator is a terminal-first wrapper for Claude and Codex sessions. You launch both agents through aiduo, then orchestrate them from inside the live sessions with /aiduo:* commands.

Quick Start

Published package:

npx aiduo help
npx aiduo claude
npx aiduo codex

If you want to pass native Claude or Codex arguments, they go through unchanged:

npx aiduo claude --resume
npx aiduo claude --continue
npx aiduo codex exec
npx aiduo codex exec --resume

AI Duo does not inject hidden defaults. claude, codex, --resume, exec, and any other flags remain under your control.

Session Workflow

1. Open two terminals in the same git repository.
2. Start Claude in one terminal.
3. Start Codex in the other terminal.
4. Keep talking to both agents normally.
5. When you want orchestration, use /aiduo:* inside the current wrapped session.

Example:

Terminal 1:

npx aiduo claude

Terminal 2:

npx aiduo codex

Inside one of those sessions:

/aiduo:review --diff

Install

No global install is required:

npx aiduo help

Optional local install:

npm install -g aiduo
aiduo help

Slash Commands

Core commands:

• /aiduo:review
• /aiduo:review --diff
• /aiduo:review --all
• /aiduo:implement
• /aiduo:plan
• /aiduo:fix
• /aiduo:judge

Helper commands:

• /aiduo:status
• /aiduo:latest
• /aiduo:cancel
• /aiduo:retry
• /aiduo:bootstrap
• /aiduo:help

Common examples:

/aiduo:review
/aiduo:review --diff
/aiduo:implement
/aiduo:plan
/aiduo:fix
/aiduo:judge

Detailed usage examples:

• Terminal usage guide

Top-Level Helper Commands

Outside the wrapped agent session, these commands are available:

npx aiduo help
npx aiduo status
npx aiduo latest
npx aiduo bootstrap
npx aiduo bootstrap --apply

These do not replace slash commands. They are repo-level helpers for setup, status, and artifacts.

Artifacts and Runtime

AI Duo writes local state under:

.ai-duo/runtime/
.ai-duo/runs/<run-id>/
.ai-duo/latest.md

What is stored there:

• session registry
• peer pairing state
• transcript events
• run metadata
• source context
• dispatched prompt
• captured response
• summaries

Current Capabilities

• PTY wrappers for claude and codex
• file-backed session registry and transcript runtime
• slash-command parser for /aiduo:*
• artifact engine for .ai-duo/runs/<id>
• bootstrap preview and apply helpers
• prompt sanitization and secret redaction helpers
• transcript-backed context resolution with --diff and --all

Current Limitations

• wrapper input is line-oriented, not full raw-terminal passthrough
• pairing is automatic by repo and latest opposite session; manual pairing flags are not added yet
• MCP sidecar and richer multi-session coordination are still future work

Local Repo Usage

You can also run it directly from the repository:

npm install
npm run build
npx --yes . help
npx --yes . claude
npx --yes . codex

GitHub source execution also works:

npx --yes github:yajinn/AIDuoOrchestrator help

Optional local global link:

npm link
aiduo help
aiduo claude
aiduo codex

Local Development

npm install
npm test
npm run build
npm run lint