Start Zellij Session For Task

Start Zellij Session For Task

Use the repo-managed start-zellij-session-for-task helper when the user wants to spin up a side task in its own zellij session without hijacking the current terminal. Codex is the default backend, but Claude and Bedrock Claude can be selected explicitly.

Invocation

$start-zellij-session-for-task [--backend codex|claude|bedccy] <linear url|linear id|github issue url|task description>
/start-zellij-session-for-task [--backend codex|claude|bedccy] <linear url|linear id|github issue url|task description>

Optional target override:

$start-zellij-session-for-task --target ml <...>

Backend override:

$start-zellij-session-for-task --backend bedccy <...>
$start-zellij-session-for-task --backend claude <...>

Paused app-server notification path:

$start-zellij-session-for-task --codex-app-notify <...>

Supported targets:

• here (default)
• ml
• arya
• agent

Command

start-zellij-session-for-task --project-root "<project-root>" <user input>

If the user explicitly names a machine, pass --target ml|arya|agent. Otherwise default to here.

If the user explicitly asks for Claude, pass --backend claude; if they ask for bedccy or Bedrock Claude, pass --backend bedccy.

Behavior

• Resolves tracker and slug context with the shared task-status resolver.
• Uses the resolved task slug as the zellij session name unless overridden.
• Uses [TRACKER-ID] as the tab name when a tracker is present.
• Launches Codex through raw vanilla codex by default, preserving the shared ~/.codex/auth.json ChatGPT login cache.
• --backend claude launches claude --dangerously-skip-permissions.
• --backend bedccy launches CLAUDE_CODE_USE_BEDROCK=1 claude --dangerously-skip-permissions.
• Use --codex-app-notify only when intentionally testing the paused App Server notification path; it only affects the Codex backend.
• Uses the current machine's default Codex profile instead of forcing a profile override when the backend is Codex.
• Clears inherited CODEX_* session metadata before starting a child Codex process.
• Seeds the child interactive session with the exact initial prompt:
  • $start-new-task <original input>
• Uses codex --dangerously-bypass-approvals-and-sandbox for Codex launches, preserving the current CLI equivalent of the historical --yolo shorthand.
• Prints the launched session name, target, attach hint, initial prompt, and any available zellij web link.
• For remote targets, fails early if the resolved project root does not exist on the target host.

Notes

• This helper intentionally does not switch the current terminal into the new session.
• Remote targets reuse the same host-selection defaults as work-ml, work-arya, and work-agent.
• If a session with the same name already exists, stop and surface the collision instead of launching a second Codex run into it.
• Use --dry-run only when the user wants to inspect the resolved launch plan without starting the session.
• If --codex-app-notify is explicitly enabled and the helper reports that codex-app-notify-session is unavailable, rerun without --codex-app-notify for the default raw-Codex path.