codex-cancel

Solid

Cancel an active background Codex job. Use when asked "codex cancel", "stop codex", "abort the codex job", or wants to stop a running Codex task.

AI & Automation 48 stars 5 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
56
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
83
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Codex Job Cancel Pass-through wrapper around the Official Codex companion's `cancel` subcommand. Exists so users who disabled the Official plugin's slash commands can still cancel jobs via codex-advisor. ## Phase 1: Confirm target (if ambiguous) If the user did not provide a `job-id`, the companion cancels the most recent active job — which may not be what they intended. Use `AskUserQuestion` when: - Multiple active jobs exist (check via `node "$CODEX_COMPANION" status` first, optional). - The user's phrasing suggests a specific job ("cancel the rescue", "stop the research") but no ID. Skip the prompt when the intent is obvious (single active job, or they pass an explicit ID). ## Phase 2: Invoke companion cancel ```bash set -o pipefail CODEX_COMPANION=$("${CLAUDE_PLUGIN_ROOT}/scripts/resolve-companion.sh") \ || { echo "Official Codex plugin not found — run /codex-setup" >&2; exit 1; } node "$CODEX_COMPANION" cancel $ARGUMENTS ``` Relay the companion's output verbatim. It typically reports `cancelled` or `no-op (not running)`. ## Gotchas - **Cancellation is not instant.** The companion signals the Codex worker; in-flight tool calls may complete before the worker exits. Don't promise "stopped immediately". - **Cancelling a rescue job does NOT revert the diff.** If Codex already wrote files under `--write`, those changes stay on disk. Remind the user to `git diff` / `git restore` if needed. - **No job-id == most recent active.** Only one job at a time is the commo...

Details

Author
LeeJuOh
Repository
LeeJuOh/claude-code-zero
Created
6 months ago
Last Updated
1 weeks ago
Language
JavaScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category