openspec list

Displays a table of active changes with task progress, or specifications with requirement counts.

Usage

openspec list [options]

Options

Option	Description
--specs	List specifications instead of changes
--changes	List changes (default)
--json	Machine-readable output

Output

Changes (default)

$ openspec list

┌─────────────────────┬──────────────┐
│ Change              │ Progress     │
├─────────────────────┼──────────────┤
│ add-user-auth       │ 3/5 tasks    │
│ update-api-schema   │ ✓ Complete   │
│ fix-validation      │ 0/3 tasks    │
└─────────────────────┴──────────────┘

Specifications

$ openspec list --specs

┌─────────────────────┬──────────────────┐
│ Spec                │ Requirements     │
├─────────────────────┼──────────────────┤
│ cli-init            │ 12 requirements  │
│ cli-list            │ 6 requirements   │
│ user-auth           │ 8 requirements   │
└─────────────────────┴──────────────────┘

JSON Output

$ openspec list --json

{
  "changes": [
    {
      "name": "add-user-auth",
      "tasksCompleted": 3,
      "tasksTotal": 5
    }
  ]
}

Examples

Check what’s in progress

openspec list

See all capabilities

openspec list --specs

Script integration

openspec list --json | jq '.changes[] | select(.tasksCompleted == .tasksTotal)'

Behavior

• Scans openspec/changes/ for change directories
• Excludes archive/ subdirectory
• Parses tasks.md for completion status
• Sorts alphabetically by name

Empty States

$ openspec list
No active changes found.

$ openspec list --specs
No specs found.

Exit Codes

Code	Meaning
0	Success
1	No OpenSpec directory found