Skip to main content

/sw:auto-status - Session Status

Show the current auto session status and progress.

Usage

/sw:auto-status [OPTIONS]

Options

OptionDescription
--jsonOutput in JSON format (for programmatic use)
--simpleMinimal output (one-liner)

Examples

# Check current session
/sw:auto-status

# Get JSON output
/sw:auto-status --json

# Quick status check
/sw:auto-status --simple

What It Shows

Session Information

  • Session ID: Unique identifier for this auto run
  • Status: Running, completed, cancelled, or paused
  • Duration: How long the session has been running
  • Iteration: Current iteration out of maximum

Progress

  • Visual progress bar
  • Increment queue status (total/completed/failed)
  • Current increment task progress

Warnings

  • Human Gate Pending: Session is waiting for human approval
  • Circuit Breakers Open: External services unavailable

Output Example

🤖 Auto Session Status

Status: 🟢 RUNNING

Session ID: auto-2025-12-29-abc123
Duration: 2h 15m
Iteration: 47 / 100

Progress: [████████████████░░░░░░░░░░░░░░] 47%

📋 Increment Queue
Total: 3 | Completed: 2 | Failed: 0

📌 Current Increment: 0003-payment-integration
Tasks: 12 / 18 (67%)

💡 Actions:
Cancel: /sw:cancel-auto
Let it run: Close this tab, work will continue

JSON Output Format

{
"active": true,
"sessionId": "auto-2025-12-29-abc123",
"status": "running",
"iteration": 47,
"maxIterations": 100,
"duration": "2h 15m",
"currentIncrement": "0003-payment-integration",
"incrementQueue": {
"total": 3,
"completed": 2,
"failed": 0
},
"currentProgress": {
"tasksCompleted": 12,
"tasksTotal": 18
},
"humanGatePending": false,
"openCircuitBreakers": 0,
"simpleMode": false
}

Status Values

StatusDescription
🟢 runningSession actively executing tasks
completedAll tasks finished successfully
⏸️ pausedWaiting for human review (low score, test failures)
cancelledUser cancelled via /sw:cancel-auto

Notes

  • Status is read from .specweave/state/auto-session.json
  • Progress is calculated from tasks.md files
  • Use --json for integration with other tools
  • The session continues even if you close the terminal

CommandPurpose
/sw:autoStart auto session
/sw:cancel-autoCancel running session
/sw:progressShow increment progress

See Also