Reference
spec list
List the project's specification documents under dirs.specs, sorted by sequence number. The table columns are index (right-aligned, space-padded), id, title, status (color-coded by lifecycle: active green with a check, draft in the warning hue, deprecated/superseded dimmed), on-disk size (right-aligned, humanized units, spec file plus any extra files), an approximate LLM token count (humanized to thousands/millions, e.g. 15 k or 2.6 M), the extra-file count, a short content hash, and file. A marginal totals footer summarizes the spec count, per-status counts, total size, total tokens, total extra files, and the three most common tags. The hash is a 12-hex-character digest over the spec body plus any appended extra_files; frontmatter is excluded, so it is stable across metadata edits. The token count is an approximation (~4 bytes per token), not a real tokenizer. A spec with missing or invalid frontmatter fails the command. Zero specs is a success with a hint to run overplane spec new.
Optional
--json
boolean default falseEmit the spec records as a canonical JSON array.