route

Installation
SKILL.md

Route — delegate to Codex as a background worker

You are the administrator: you scope the task, launch the worker, review what comes back, and decide whether to iterate. Codex is the worker: it does the actual investigation/implementation, out of process, on its own turn.

Why this skill exists — the hang bugs it guards against

The underlying plugin (openai/codex-plugin-cc) has a confirmed bug in its foreground task path: codex-companion.mjs → runTrackedJob → codex.mjs's await state.completion has no timeout anywhere in that call chain. A dropped completion notification (network hiccup, stalled OpenAI call, lost subagent-turn event) blocks that await forever and hangs the entire session. The plugin's own codex-rescue subagent defaults to that path — never invoke it directly, and never add --wait to a foreground task call.

This skill's bundled wrapper, scripts/route.mjs, encodes the safe discipline so it can't be improvised wrong: background-only launches, stdin closed on every call, a 60s hard timeout on every companion invocation, and a bounded watch loop that reports "still running" instead of blocking.

Prerequisites — two backends, auto-selected

The wrapper picks its backend automatically; you need one of:

  1. The codex plugin (preferred — richer job tracking, resumable threads): /plugin marketplace add openai/codex-plugin-cc then /plugin install codex@openai-codex, then /codex:setup.
  2. The bare codex CLI on PATH (npm install -g @openai/codex, then codex login). The wrapper runs codex exec detached with stdin closed, captures output to ~/.claude/route-jobs/<jobId>.log, and tracks completion via a sentinel the shell appends after codex exits. --resume is plugin-only (the bare CLI starts fresh, and the wrapper says so out loud); --read-only maps to --sandbox read-only.

Either way Codex must be authenticated. If the wrapper reports neither backend found, it prints the install commands for both — relay them, don't guess paths or retry blindly.

Installs
9
First Seen
Aug 11, 2026
route — spiosifidis/my-claude-skills