/cancel-auto

disable-model-invocation: true
description: EMERGENCY ONLY - Cancel running auto session and generate summary report.

Cancel Auto Command

Project Overrides

**Skill Memories**: If `.specweave/skill-memories/cancel-auto.md` exists, read and apply its learnings.

**⚠️ EMERGENCY USE ONLY - Manually cancel the running auto session.**

> **Note**: Auto mode is designed to run until completion. In most cases, just close the Claude Code session and resume later with `sw:do`. Only use this command in true emergencies.

Usage

sw:cancel-auto [OPTIONS]

Options

| Option | Description | |--------|-------------| | `--force` | Cancel without confirmation |

Examples

# Interactive cancel (asks for confirmation)
sw:cancel-auto

# Force cancel without confirmation (emergency)
sw:cancel-auto --force

What It Does

1. Checks if auto session is active 2. Shows current session status 3. Asks for confirmation (unless --force) 4. Updates session status to "cancelled" 5. Releases session lock 6. Generates summary report

Output Example

📊 Current Session

Session ID: auto-2025-12-29-abc123
Status: running
Iteration: 47
Current Increment: 0001-user-auth
Increments Completed: 2
Duration: 2h 15m

Cancel this session? [y/N] y

✅ Session cancelled

Summary: .specweave/logs/auto-2025-12-29-abc123-summary.md

💡 To resume work later, just run sw:do

Execution

When this command is invoked:

bash plugins/specweave/scripts/cancel-auto.sh [args]

Notes

• **This command should rarely be needed** - auto mode is designed to run until completion
• **Preferred approach**: Just close the Claude Code session to pause, resume later with `sw:do`
• Cancelling doesn't undo completed work
• tasks.md progress is preserved
• You can resume anytime with `sw:do`
• Use Claude Code's `/resume` to restore full conversation context

When to Use

**Use cancel-auto only for:**

• True emergencies (system resources, critical bugs)
• Need to force-stop a runaway session

**DON'T use for:**

• Normal pause/resume (just close Claude Code)
• Switching contexts (close tab, resume later)
• Profile switches (not supported - wrong concept)