Runner — Codex GUI
Run a full Linear project queue inside native Codex desktop — visible lanes, worktrees, serial integration, self-healing.
What this skill does
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.
Where it lives and how to install it
- 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/
curl -sSf https://superada.ai/install/runner-codex-gui | shInstall 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 | shInstall 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.mdFull GUI execution workflow with eight non-negotiable architecture rules.
- Control plane and recovery
superada:runner-codex-gui/references/control-plane-and-recovery.mdManager-worker-reviewer control plane and self-healing recovery patterns.
- Human approval packets
superada:runner-codex-gui/references/human-approval-packets.mdHow and when to escalate blockers for human approval.
- Native Codex GUI control
superada:runner-codex-gui/references/native-codex-gui-control.mdCodex desktop automation primitives, task lifecycle, and Scheduled automation.
- Validation script
superada:runner-codex-gui/scripts/validate_runner_codex_gui.pyValidates GUI runner setup against the contract.
- Lane manifest
superada:runner-codex-gui/templates/lane-manifest.mdManifest tracking issue → task ID → worktree → ownership → branch.
- Manager directive
superada:runner-codex-gui/templates/manager-directive.mdTop-level prompt for the Codex manager task.
- Scheduled automation directive
superada:runner-codex-gui/templates/scheduled-automation-directive.mdNative Codex Scheduled automation self-healing prompt.