UI/UX sweep: CLI #183

closed cmc opened this on 2026-09-07 18:04 UTC

Discussion

cmc 2026-09-07 18:04 UTC

--json is the contract and the human output is not, so nobody has designed the human output. email list prints tab-separated columns because keys list does. Decide the rules once, write them on the wiki's Users page, then apply them noun by noun:

  • column layout and alignment for list commands
  • what goes to stdout and what to stderr
  • how a refusal reads: exit 4 messages should say what to do instead
  • how usage errors read, and whether every command names its usage
  • consistency of verbs across nouns (list, show, create, remove, edit)

Output: the rules on the wiki, then one MR per noun.

closed by cmc in commit 3a0bc31b3d: CHANGELOG: CLI output sweep

2026-09-12 06:14 UTC

referenced in commit 83d1ba3b20 by cmc: control: every refusal says what to do instead

2026-09-12 06:14 UTC

referenced in commit 0215292cee by cmc: control: an empty list says so on stderr

2026-09-12 06:14 UTC

referenced in commit be3e6f28d7 by cmc: control, cli, wiki: admin runners remove, with forget as an alias for one release

2026-09-12 06:14 UTC

referenced in commit 4cfe0c4c82 by cmc: control: status list and repo topics print rows

2026-09-12 06:14 UTC

referenced in commit 0e343a88e5 by cmc: wiki: the plain-output rules

2026-09-12 06:14 UTC

referenced in commit dbc19527c5 by cmc: cli: align list rows into columns at a terminal

2026-09-12 06:14 UTC

referenced in commit fa2d1b2316 by cmc: control: one source for every command's usage

2026-09-12 06:14 UTC