Cli
betterspec show
View all spec files for a change
betterspec show
View all spec files for a change in a single readable layout. Shows the proposal, requirements, scenarios, design, and tasks — everything in one place.
Usage
betterspec show [change]If [change] is omitted, an interactive picker lets you select from active changes.
Arguments
| Argument | Description |
|---|---|
change | The change slug to view (optional — picker shown if omitted) |
Options
| Option | Description |
|---|---|
-C, --cwd <path> | Run as if betterspec was started in the given path |
Output
Displays each spec file in order:
- Proposal — The original motivation, scope, and success criteria
- Requirements — Functional and non-functional requirements
- Scenarios — Acceptance scenarios, edge cases, and error cases
- Design — Technical approach and architecture decisions
- Tasks — Implementation checklist with current status
Sections with no content are shown as (not yet written).
Example
$ betterspec show add-rate-limiting
╭─ add-rate-limiting (in-progress) ──────────────────────────────────╮
│ Created: 2025-03-10 Updated: 2025-03-14 │
│ │
│ Proposal │
│ # Proposal: add-rate-limiting │
│ ## Motivation │
│ Add per-API-key rate limiting to prevent abuse and ensure fair │
│ usage across tenants. │
│ ... │
│ │
│ Requirements │
│ # Requirements: add-rate-limiting │
│ ## Functional Requirements │
│ 1. Rate limits are enforced per API key │
│ 2. Three tiers: free (100/min), pro (1000/min), enterprise (custom) │
│ ... │
╰─────────────────────────────────────────────────────────────────────╯Alias
betterspec clarify <change> is an alias for betterspec show and is kept for backward compatibility.