Agent-installable Execution Source review 3 minutes
Runner — Codex GUI
Run a full Linear project queue inside native Codex desktop — visible lanes, worktrees, serial integration, self-healing.
Turn a Linear-backed repository queue into an autonomous Codex desktop-app run with one visible manager task, visible top-level worker/reviewer tasks, isolated worktrees, serialized integration, native Scheduled automation, self-healing recovery, blocker escalation, and exact completion proof. The GUI sibling of Runner — not a CLI wrapper.
Install contract
Source
superada.ai/skills/runner-codex-gui
Entrypoint
SKILL.md
Installability
Ready for agent install
Source spec
superada:runner-codex-gui
This page is designed to be the thing you send to another agent. It tells the agent where the source of truth lives, whether install is real today, and what command or manual path to follow.
Canonical source
https://superada.ai/skills/runner-codex-gui/ Install command
curl -sSf https://superada.ai/install/runner-codex-gui | sh Prompt to hand another agent
Install the skill described on this page from superada:runner-codex-gui. Review the source first, then run: curl -sSf https://superada.ai/install/runner-codex-gui | sh Install steps
Step 1
Install the skill from the SuperAda installer.
Step 2
Resolve required inputs: repository root, approved child queue + DAG, source authority, AGENTS.md, proof commands.
Step 3
Create the manager task, then spawn worker/reviewer sibling tasks per issue.
Step 4
Attach one native Codex Scheduled automation to the manager for self-healing.
Step 5
Run until every approved child issue is verified, integrated, and reconciled in Linear.
What it covers
- One visible parent manager task owning queue, integration, and run state
- Visible top-level worker/reviewer sibling tasks in Codex sidebar
- One issue per isolated worktree with ownership generation tracking
- Independent reviewer binding verdict to exact candidate HEAD
- Serial integration — only the manager mutates canonical main
- Native Codex Scheduled automation for self-healing continuation
- Blocker escalation and semantic-stop completion proof
Good use cases
- Run a whole Linear project in Codex desktop GUI
- Keep issue lanes visible in the Codex sidebar with manager + worker tasks
- Migrate an active CLI Runner into Codex GUI
- Add a native Codex automation that checks and repairs stalled progress
Published artifacts
Skill contract
superada:runner-codex-gui/SKILL.md
Full GUI execution workflow with eight non-negotiable architecture rules.
Control plane and recovery
superada:runner-codex-gui/references/control-plane-and-recovery.md
Manager-worker-reviewer control plane and self-healing recovery patterns.
Human approval packets
superada:runner-codex-gui/references/human-approval-packets.md
How and when to escalate blockers for human approval.
Native Codex GUI control
superada:runner-codex-gui/references/native-codex-gui-control.md
Codex desktop automation primitives, task lifecycle, and Scheduled automation.
Validation script
superada:runner-codex-gui/scripts/validate_runner_codex_gui.py
Validates GUI runner setup against the contract.
Lane manifest
superada:runner-codex-gui/templates/lane-manifest.md
Manifest tracking issue → task ID → worktree → ownership → branch.
Manager directive
superada:runner-codex-gui/templates/manager-directive.md
Top-level prompt for the Codex manager task.
Scheduled automation directive
superada:runner-codex-gui/templates/scheduled-automation-directive.md
Native Codex Scheduled automation self-healing prompt.