Commit ee77220399

ee77220399108b4f7c3559f15a8083fe28b8d021

parent: ee57439e55

Verified · cmc ci/build: success ci/test: success

cmc <hello@cleberg.net> · 2026-10-02 03:19 UTC

docs: header rows, dim references, here=

Ref #317

Layout: unified · split

.gitbay/wiki/Users.org +13 −6
@@ -1010,16 +1010,18 @@ first argument, and ignores it over HTTP. =color= is the one option
10101010the server acts on; it ignores options it does not know. The server
10111011then prints:
10121012
1013- lists under a header, padded, fitted to the width (the title or
1014 description column is cut with =…= first; a title or description
1015 column blank on most rows is held to a third of the width), with no
1016 trailing whitespace, and the next page as a command on stderr (piped
1017 output keeps a =next\t<cursor>= row instead);
1013- lists padded and fitted to the width (the title or description
1014 column is cut with =…= first; a title or description column blank on
1015 most rows is held to a third of the width), with no trailing
1016 whitespace. A list has a dim header row only when a column is a
1017 number or a size, which would not say what it counts without one. The
1018 next page is a =Next page= line on stderr with the command that
1019 fetches it (piped output keeps a =next\t<cursor>= row instead);
10181020- colour by meaning: green for open, success, approved, verified; magenta
10191021 for merged; red for failures, =private=, and bad or untrusted
10201022 signatures; dim for closed, pending, archived, unsigned; yellow only
10211023 for what waits on you (an unverified address); references (=#12=,
1022 =krz/gitbay=, SHAs) in cyan. A marker piped output keeps as its own
1024 =krz/gitbay=, SHAs) dim. A marker piped output keeps as its own
10231025 trailing cell (=[archived]=, =primary=) joins the state at a terminal:
10241026 =public, archived=;
10251027- lists that say what to do next: =mr list= with checks, review state
@@ -1051,6 +1053,11 @@ then prints:
10511053=GITBAY_PAGER= turns paging off. Paging never applies to =--follow=,
10521054=--json=, or piped output.
10531055
1056Inside a clone of a repository on the instance, the CLI adds
1057=here=<owner/name>= to =--term=, so a command the output suggests leaves
1058that repository out, as the CLI would infer it. An instance that does
1059not know the option ignores it.
1060
10541061=GITBAY_TERM=off= stops the CLI sending =--term= at all, for an
10551062instance older than v1.36.0, which refuses the argument as an unknown
10561063command.
CHANGELOG.org +9
@@ -4,6 +4,15 @@ Versioning follows semver from v0.1.0. Database migrations run
44automatically on daemon start; upgrade notes appear per release when
55anything beyond "replace the binary and restart" is needed.
66
7* Unreleased
8
9- Lists at a terminal drop their header row unless a column is a number
10 or a size, and references are dim instead of cyan (#317). The next
11 page is a =Next page= line with the command. Inside a clone, the CLI
12 sends the repository it inferred as =here== in =--term=, so suggested
13 commands leave it out; an older instance ignores the option. Piped
14 and =--json= output are unchanged.
15
716* v1.41.0 — 2026-10-01
817
918Terminal output that reads at a glance (#312–#315): colour by meaning,