skills.rest
ma08
ma08COMMUNITY
Explore all skills by this author →
Website𝕏@curious_queueGitHub

zellij-detached-codex-launch-verification

Verify active Codex UI in detached Zellij sessions and fix launcher scripts.

28|Updated Jan 3, 2026
Search Tags:#codex#zellij#task-activation#coding-agents#session-verification#launch-debugging#pane-inspection
One-click install
npx skills add https://github.com/ma08/botfiles --skill zellij-detached-codex-launch-verification
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zellij-detached-codex-launch-verification
Source: https://github.com/ma08/botfiles/tree/main/hermes/skills/software-development/zellij-detached-codex-launch-verification
Command: npx skills add https://github.com/ma08/botfiles --skill zellij-detached-codex-launch-verification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the common issue of false positive task activation when launching Codex in detached Zellij sessions: a session may appear in session lists, but the attached pane only shows an idle shell with no visible Codex UI, leading to incorrect claims that the task is running.

Core Features & Use Cases

  • Live Session Validation: Inspect active Zellij panes to confirm visible Codex UI, seeded task prompts, and correct repository working directory, rather than relying solely on session existence.
  • Launcher Script Fixes: Adjust launch workflows that only create detached sessions without spawning Codex processes to produce inspectable, running panes.
  • State Alignment: Normalize task tracker status to match verified active sessions, avoiding unnecessary broadening of supervision for inactive tasks. Use Case: If your coding agent reports a Codex task is active but attaching to the Zellij session only shows a blank shell, use this skill to debug the launch, fix the underlying launcher issue, and confirm real task activation.

Quick Start

Use this skill to debug a Zellij Codex task that shows a shell instead of the Codex UI when you attach to the session.

Frequently Asked Questions about zellij-detached-codex-launch-verification

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Zellij session show an idle shell instead of the Codex UI when I attach to it?▼

A false positive in Zellij task activation occurs when a session exists in the list but the attached pane displays an idle shell instead of the visible Codex UI. This skill resolves the discrepancy by validating live pane content against the task tracker status.

How do I verify that a detached Codex task is actually running in Zellij?▼

To verify a detached Codex task is running, inspect the active Zellij panes to confirm the visible Codex UI, check the process tree, and ensure the working directory matches your repository. This skill aligns the live session state with your task tracker status.

How do I fix a launcher script that creates a Zellij session but fails to spawn Codex?▼

Fix a broken Zellij launcher script by adjusting the detached session creation workflow to directly spawn and attach the Codex process. This skill debugs the launch sequence to produce inspectable, running panes with seeded task prompts.

Do I need to check the process tree to confirm Codex task activation in Zellij?▼

Yes, checking the process tree is required to confirm Codex task activation in Zellij. Relying solely on session existence causes false positives, so this skill validates task activation via process tree checks and visible UI inspection.

Can this skill normalize task tracker status to match active Zellij sessions?▼

Yes, this skill normalizes task tracker status to match verified active Zellij sessions. It prevents unnecessary broadening of supervision for inactive tasks by aligning the tracker with the actual live session state and visible Codex UI.

Related Skills

Explore More Software Engineering Skills→
ma08ma08
28

zellij-cross-session-orchestration

Launch, inspect, and message detached zellij coding agent sessions.

Community
Advanced
ma08ma08
28

save-task-status

Reconcile task status metadata and sync tracker links for coding agent workflows.

Community
Intermediate
ma08ma08
28

start-zellij-session-for-task

Launch isolated detached zellij sessions for parallel coding agent tasks.

Community
Intermediate
ma08ma08
28

create-ticket-session

Create Linear tickets and launch detached zellij/Codex worker sessions.

Community
Intermediate