CLI output refresh: tables, show views, help #254

closed cmc opened this on 2026-09-24 00:22 UTC

Discussion

cmc 2026-09-24 00:22 UTC

The CLI's plain output has not had a design pass since v1.22.0. Tables have no header, width or colour; show views print web markup ([cmc](/cmc)) and raw stored timestamps; help crams usage into summaries and flags have no descriptions.

Scope:

  • Terminal rendering on the server, selected by GITBAY_TERM sent by the CLI: tables with a header, state colour, width fitting and relative ages; show views with rendered markdown/org; a pager in the CLI.
  • Help: per-flag descriptions and examples in the registry; grouped root, noun and verb layouts.
  • Piped output stays tab-separated with no header; timestamps become RFC3339 to the second.
  • Audit fixes: release list paging and the duplicated tag, notifications device add message, build log --follow queued timeout, usageWith coverage, empty dashboard sections, stale build list help.

Spec: docs/specs/2026-09-23-cli-output-refresh-design.md.

referenced in commit 683d5a1794 by cmc: release list: cursor carries created_at and id

2026-09-24 15:08 UTC

referenced in commit 3e18e86aa4 by cmc: dashboard: none under an empty section

2026-09-24 15:08 UTC

referenced in commit aa02c5e909 by cmc: notifications device add: verb first

2026-09-24 15:08 UTC

referenced in commit 8eb3623130 by cmc: release list: --limit and --cursor; no title column when it repeats the tag

2026-09-24 15:08 UTC

referenced in commit 2dd892270a by cmc: docs/plans: CLI output refresh

2026-09-24 15:08 UTC

referenced in commit 9a566ebe6f by cmc: docs/specs: CLI output refresh design

2026-09-24 15:08 UTC

referenced in commit b698d850a1 by cmc: e2e: terminal and plain runs must succeed

2026-09-24 15:08 UTC

referenced in commit 522169051e by cmc: control: runner fingerprints shrink; the one-revision note goes to stderr

2026-09-24 15:08 UTC

referenced in commit ed403b692d by cmc: e2e: read commands carry no SGR when plain and fit 60 columns at a terminal

2026-09-24 15:08 UTC

referenced in commit faf8245dca by cmc: control: fingerprint columns and help summaries fit a narrow terminal

2026-09-24 15:08 UTC

referenced in commit b8cd3fd9d0 by cmc: control: account, org, admin, notification, snippet, feed and dashboard lists as tables

2026-09-24 15:08 UTC

referenced in commit b96e074d36 by cmc: control: repository, history, status, wiki, mirror, runner and webhook lists as tables

2026-09-24 15:08 UTC

referenced in commit cd2df24eb6 by cmc: search: repository rows line up under TITLE at a terminal

2026-09-24 15:08 UTC

referenced in commit 00817b309d by cmc: control: issue, mr, build, release, label, milestone, search and explore lists as tables

2026-09-24 15:08 UTC

referenced in commit fd7099acea by cmc: gitbay: send GITBAY_TERM at a terminal; --no-color; drop client-side column padding

2026-09-24 15:08 UTC

referenced in commit 9594a7a725 by cmc: control: quote the next-page command

2026-09-24 15:08 UTC

referenced in commit 7000aa47b1 by cmc: control: the next page as a command on stderr at a terminal

2026-09-24 15:08 UTC

referenced in commit 3d834e058d by cmc: table: keep cells beyond the header

2026-09-24 15:08 UTC

referenced in commit c1ccabf7ee by cmc: sshd: GITBAY_TERM selects terminal output per session

2026-09-24 15:08 UTC

referenced in commit 81fbd1e949 by cmc: control: relAge truncates; pin the table test clock past the hour

2026-09-24 15:08 UTC

referenced in commit 061d70831a by cmc: control: table, plain rows or a fitted terminal table

2026-09-24 15:08 UTC

referenced in commit e410f8a408 by cmc: control: Term, cell width, clipping and timestamp formats

2026-09-24 15:08 UTC

referenced in commit 171bcbd6c9 by cmc: e2e: repo show assertions follow the field layout

2026-09-24 15:08 UTC

referenced in commit b862e4a67c by cmc: gitbay: page views, diffs and logs at a terminal

2026-09-24 15:08 UTC

referenced in commit 02a6794816 by cmc: view: sections label sub-tables; full hashes; wiki source when piped

2026-09-24 15:08 UTC

referenced in commit 98ba76cb39 by cmc: control: every show on the view layout

2026-09-24 15:08 UTC

referenced in commit acbc0f60ee by cmc: control: mr show on the view layout

2026-09-24 15:08 UTC

referenced in commit f830a4d84c by cmc: view: wrap titles and field values to the terminal

2026-09-24 15:08 UTC

referenced in commit 1706e2f65b by cmc: control: view layout; issue show on it

2026-09-24 15:08 UTC

referenced in commit 211e3d4c4f by cmc: termtext: org lists stay tight; includes and keyword gaps render nothing

2026-09-24 15:08 UTC

referenced in commit 468df8e4c3 by cmc: termtext: org for a terminal

2026-09-24 15:08 UTC

referenced in commit 49ab072901 by cmc: termtext: close colour at the end of a wrapped line

2026-09-24 15:08 UTC

referenced in commit 0670ca4ed6 by cmc: termtext: markdown for a terminal

2026-09-24 15:08 UTC

referenced in commit d62f20728d by cmc: e2e: noun help lists verbs, verb help carries flags

2026-09-24 15:08 UTC

referenced in commit a9633bdd35 by cmc: gitbay: summaries generated from the registry; grouped root help

2026-09-24 15:08 UTC

referenced in commit 54236b3f88 by cmc: help: usage keeps required flags; owner/name as written

2026-09-24 15:08 UTC

referenced in commit c2a6cbdbec by cmc: help: noun and verb layouts, flags and examples from the registry

2026-09-24 15:08 UTC

referenced in commit c5be40147c by cmc: control: every command's flags described, with examples

2026-09-24 15:08 UTC

referenced in commit a9749f2107 by cmc: control: examples that run as written

2026-09-24 15:08 UTC

referenced in commit 3fc5fe7f24 by cmc: control: examples redirect like a shell

2026-09-24 15:08 UTC

referenced in commit 99ec0bbcaf by cmc: control: flags described and examples for work and repository commands

2026-09-24 15:08 UTC

referenced in commit 5ed0f4f4cc by cmc: control: termSafe drops carriage returns

2026-09-24 15:08 UTC

referenced in commit dd23d1750e by cmc: control: gofmt the generated summaries; drop unused helpers

2026-09-24 15:08 UTC

referenced in commit 4b7a42dfb4 by cmc: view: every sub-table under a section label

2026-09-24 15:08 UTC

referenced in commit 037e004e54 by cmc: control: control bytes in user text never reach the terminal

2026-09-24 15:08 UTC

referenced in commit f513f70f9a by cmc: control: --term only first, never over HTTP

2026-09-24 15:08 UTC

referenced in commit 1712c81b0a by cmc: gitbay: GITBAY_TERM=off sends no terminal size

2026-09-24 15:08 UTC

closed by cmc in commit dd06e80a07: docs: terminal output rules, sshd note, changelog

2026-09-24 15:08 UTC