3.2 KiB
3.2 KiB
| description | argument-hint | context | allowed-tools |
|---|---|---|---|
| Delegate investigation, an explicit fix request, or follow-up rescue work to the Codex rescue subagent | [--background|--wait] [--resume|--fresh] [--model <model|spark>] [--effort <none|minimal|low|medium|high|xhigh>] [what Codex should investigate, solve, or continue] | fork | Bash(node:*), AskUserQuestion |
Route this request to the codex:codex-rescue subagent.
The final user-visible response must be Codex's output verbatim.
Raw user request: $ARGUMENTS
Execution mode:
- If the request includes
--background, run thecodex:codex-rescuesubagent in the background. - If the request includes
--wait, run thecodex:codex-rescuesubagent in the foreground. - If neither flag is present, default to foreground.
--backgroundand--waitare execution flags for Claude Code. Do not forward them totask, and do not treat them as part of the natural-language task text.--modeland--effortare runtime-selection flags. Preserve them for the forwardedtaskcall, but do not treat them as part of the natural-language task text.- If the request includes
--resume, do not ask whether to continue. The user already chose. - If the request includes
--fresh, do not ask whether to continue. The user already chose. - Otherwise, before starting Codex, check for a resumable rescue thread from this Claude session by running:
node "${CLAUDE_PLUGIN_ROOT}/scripts/codex-companion.mjs" task-resume-candidate --json
- If that helper reports
available: true, useAskUserQuestionexactly once to ask whether to continue the current Codex thread or start a new one. - The two choices must be:
Continue current Codex threadStart a new Codex thread
- If the user is clearly giving a follow-up instruction such as "continue", "keep going", "resume", "apply the top fix", or "dig deeper", put
Continue current Codex thread (Recommended)first. - Otherwise put
Start a new Codex thread (Recommended)first. - If the user chooses continue, add
--resumebefore routing to the subagent. - If the user chooses a new thread, add
--freshbefore routing to the subagent. - If the helper reports
available: false, do not ask. Route normally.
Operating rules:
- The subagent is a thin forwarder only. It should use one
Bashcall to invokenode "${CLAUDE_PLUGIN_ROOT}/scripts/codex-companion.mjs" task ...and return that command's stdout as-is. - Return the Codex companion stdout verbatim to the user.
- Do not paraphrase, summarize, rewrite, or add commentary before or after it.
- Do not ask the subagent to inspect files, monitor progress, poll
/codex:status, fetch/codex:result, call/codex:cancel, summarize output, or do follow-up work of its own. - Leave
--effortunset unless the user explicitly asks for a specific reasoning effort. - Leave the model unset unless the user explicitly asks for one. If they ask for
spark, map it togpt-5.3-codex-spark. - Leave
--resumeand--freshin the forwarded request. The subagent handles that routing when it builds thetaskcommand. - If the helper reports that Codex is missing or unauthenticated, stop and tell the user to run
/codex:setup. - If the user did not supply a request, ask what Codex should investigate or fix.