Skip to main content
Hand a task to Codex through the codex:codex-rescue subagent. Codex runs with write access by default, so it can investigate, propose fixes, and apply changes to your repository. Use this command when you want Codex to investigate a bug, try a fix, continue a previous task, or take a faster pass with a smaller model.

​
Syntax

/codex:rescue [--background|--wait] [--resume|--fresh] [--model <model|spark>] [--effort <none|minimal|low|medium|high|xhigh>] [what Codex should investigate, solve, or continue]

​
Flags

​
--background
boolean
Run the task as a background job. Use /codex:status to check progress.
​
--wait
boolean
Run in the foreground and wait for Codex to finish before returning.
​
--resume
boolean
Continue the latest Codex task thread for this repository. Skips the resume prompt.
​
--fresh
boolean
Force a new thread even if a resumable one exists. Skips the resume prompt.
​
--model
string
Specify a model. Use spark as a shorthand for gpt-5.3-codex-spark. If omitted, Codex uses its own default.
​
--effort
string
Set the reasoning effort level. Accepted values: none, minimal, low, medium, high, xhigh. If omitted, Codex uses its own default.

​
Examples

/codex:rescue investigate why the tests started failing
/codex:rescue fix the failing test with the smallest safe patch
/codex:rescue --resume apply the top fix from the last run
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test
/codex:rescue --model spark fix the issue quickly
/codex:rescue --background investigate the regression

​
Natural language delegation

You can also describe the task conversationally rather than using the slash command directly: 
Ask Codex to redesign the database connection to be more resilient.
Claude Code will route the request to Codex through the codex:codex-rescue subagent.

​
Resume behavior

If you omit both --resume and --fresh, the plugin checks whether a resumable thread exists from the current Claude session:
  • If a resumable thread is found, it asks once whether to continue the existing thread or start a new one.
  • If your request sounds like a follow-up — for example, “continue”, “keep going”, “apply the top fix”, or “dig deeper” — the plugin puts Continue current Codex thread as the recommended choice.
  • Otherwise, Start a new Codex thread is recommended.
  • If no resumable thread is found, the plugin starts a fresh run without asking.
Tasks using larger models or xhigh effort may run for a long time. For these, background mode is recommended. You can check progress with /codex:status and retrieve the output with /codex:result.
For more on thread resumption and continuing prior Codex work, see Resuming sessions.