Agent skill · ma08
zellij-detached-codex-launch-verification
Debug and fix detached Zellij launches for Codex tasks when session creation succeeds but the attached pane only shows a shell or no visible Codex UI.
What it needs
About 2k tokens when loaded.
What this skill does
When to use Use when Hermes/botfiles pickup or launcher flows claim a Zellij session was started for a Codex task, but attaching shows only an idle shell, missing task metadata, or verification based only on zellij list-sessions. Core lesson A detached Zellij session existing is not sufficient evidence that Codex launched successfully. Verify a real visible pane and the Codex process/UI before treating the lane as active. Steps 1. Inspect the ticket/session state Check whether the Linear ticket actually contains repo-local evidence. If not, use the default project root policy (currently ~/pro/personalos for Arya ambiguous tickets). Inspect the live session: zellij list-sessions zellij action query-tab-names --session <session> zellij action dump-screen --session <session> -p <paneid> -f 2. Check whether the launcher is over-crediting success Look at the launcher script and verify whether it only: creates a session, or also creates a pane running Codex. If verification only checks zellij list-sessions, that is insufficient. 3. Validate --dry-run honestly Run: start-zellij-session-for-task --project-root <root> --dry-run <ISSUE> Confirm whether dry-run only prints the launch plan/script. Do not attribute launch-time pane verification failures to --dry-run unless the tool truly performs launch under dry-run. 4. Fix detached launch behavior Creating a detached session plus setting options --default-shell <bootstrap> may not produce a visible pane that can be inspected. Preferred fix on this setup: 1. create the detached session 2. launch the bootstrap as a real pane command with: ZELLIJSESSIONNAME=<session> zellij run -- <bootstrappath> This creates an inspectable pane like terminal1 that actually runs Codex. 5. Strengthen verification After launch, inspect the real pane (terminal1 or returned pane) with dump-screen. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/zellij-detached-codex-launch-verification