Auto Status Command

Show the current auto session status and progress.

Usage

/sw:auto-status [OPTIONS]

Options

Option	Description
--json	Output in JSON format (for programmatic use)
--simple	Minimal 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
}

Execution

When this command is invoked:

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

Related Commands

Command	Purpose
/sw:auto	Start auto session
/sw:cancel-auto	Cancel running session
/sw:approve-gate	Approve pending human gate

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