| name | codex-orchestrator |
| description | Monitor, control, and orchestrate background Codex sessions. Use this skill to track progress, handle interruptions, and ensure task completion for long-running coding tasks. |
Codex Orchestrator
This skill provides a workflow for supervising the Codex coding agent running in background processes.
Workflow
1. Start (Launch)
Always launch Codex in a background PTY session to maintain interactivity without blocking the main agent.
bash pty:true workdir:<target_dir> background:true command:"codex exec --full-auto '<PROMPT>'"
- Store the returned
sessionId.
- If
sessionId is lost, find it via process action:list.
2. Monitor (Watch)
Check progress regularly (e.g., via cron or manual check).
process action:log sessionId:<id> limit:2000
Signs of life:
- Spinner animations or progress bars updating.
- "Working...", "Thinking...", "Running...".
- File edits (
Edit ...).
Signs of blockage:
- Interactive prompts (e.g., "Select directory", "Approve change [y/n]").
- No log output for >5 minutes (process might be hung or waiting for hidden input).
3. Intervene (Control)
If Codex is stuck at a prompt:
process action:submit sessionId:<> data:
process action:submit sessionId:<> data: