code-oz-resume

A command for continuing a code-oz run that stopped at a pause or intervention checkpoint.

In plain words
What is it for?
It resumes paused runs and passes the engine's output or any new stop or pause file path back to the user.
Why use it?
It lets the run pick up from its last completed checkpoint instead of starting over.

Command

Part of the code-oz plugin — 4 commands, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/omerakben/code-oz/code-oz-resume
Clone the repo
git clone --depth 1 https://github.com/omerakben/code-oz

Or install code-oz, the plugin that ships this one along with the rest of its 4 commands, 1 hook.

Per session 15 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 426 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00015 $0.00426
Opus 5 $0.00008 $0.00213
Sonnet 5 $0.00003 $0.00085
Haiku 4.5 $0.00002 $0.00043

Measured 2d ago against content hash 43aab9cfb7ca, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

code-oz-resume scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/code-oz/commands/code-oz-resume.md · 37 lines

What it actually says

This command only invokes the code-oz engine. Do not write .code-oz/, do not decide pass/fail, do not simulate review, and do not summarize gate/review status beyond engine output.

What it does

code-oz resume continues a run that stopped at a NEEDS_INTERVENTION.json or PAUSE.json gate. The engine replays the recorded effective budget envelope and picks up from the last committed gate.

Cost notice

This command spawns providers, may cost money, and changes files in the worktree. Because you explicitly invoked it, you may proceed — state this in one line before running. If invoked ambiguously (not a clear user request), ask for one explicit confirmation first.

How to run it

bash "${CLAUDE_PLUGIN_ROOT}/scripts/resolve-code-oz.sh" resume "$ARGUMENTS"

The resolver finds the engine via PATH binary, then npx fallback, then stops with install guidance. If it stops, surface that guidance verbatim; do not work around it.

Surface results

Relay the engine's stdout and stderr verbatim. If the engine writes a new NEEDS_INTERVENTION.json, a PAUSE.json, or a STOP.json, surface the file path verbatim and stop. Do not open it and do not decide pass/fail or summarize a verdict.

Boundaries

  • Do not write under .code-oz/ for any reason.
  • Do not declare or emit gate state (GATE_*); the engine is the only gate writer.
  • Do not decide pass/fail from engine output.
  • Do not simulate or claim to perform cross-family review; the engine owns that.
  • Do not retry automatically after a second NEEDS_INTERVENTION; surface it and stop.
  • If the engine exits non-zero, show the stderr to the user without paraphrasing.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 37 lines · 15 tokens per session scan A 43aab9cfb7ca

Subscribe to this mod's changes

code-oz-resume is a command published in the GitHub repository omerakben/code-oz (2 stars, last pushed 2mo ago), licensed MIT. It adds 15 tokens to every session and 426 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.