Commit fe7b667eb3

fe7b667eb3c4b5402de51c209c7422e287b2dde8

parent: c75998ff8e

Verified · cmc

cmc <hello@cleberg.net> · 2026-10-02 04:40 UTC

docs: every list and show is a screen

Closes #319

Layout: unified · split

.gitbay/wiki/Users.org +18 −35
@@ -1024,41 +1024,24 @@ then prints:
10241024 =krz/gitbay=, SHAs) dim. A marker piped output keeps as its own
10251025 trailing cell (=[archived]=, =primary=) joins the state at a terminal:
10261026 =public, archived=;
1027- =mr list=, =issue list= and =build list= as one-section screens:
1028 each row led by =●= when it waits on you (your review requested, an
1029 issue assigned to you), otherwise by its checks' or state's glyph;
1030 =mr list= with review state, branch and age, =issue list= with
1031 labels, assignees, comments and age. A =dashboard= screen opens with
1032 what waits on you, then open merge requests, failed builds (a job's
1033 latest build only), five lines of activity with a count of builds
1034 that passed, and pinned repositories; for admins a =Problems= line
1035 counts background failures, and =admin stats= has the detail. A
1036 column empty on every row is left out. These columns are
1037 terminal-only; piped rows keep their own;
1038- diffs coloured (file headers bold, hunks cyan, added green, removed
1039 red), and =build log= with its step lines bold, the failed one red;
1040 both made safe like any user text, the log's own colour codes dropped;
1041- ages as =2h ago= and =in 5h=, sizes as =3.0 MiB=, durations as
1042 =53m43s=, where piped output keeps RFC3339, bytes and seconds;
1043- =mr show=, =issue show=, =repo show= and =build show= drawn as
1044 screens: a header block of =Label:= lines (labels dim), the
1045 description, sections titled =Title (n)= in bold blue (=Commits=,
1046 =Files=, =Discussion=, =Events=, =Steps=, open merge requests and
1047 issues), and a legend under a rule of the commands that apply now,
1048 grouped (=Unblock=, =Review=, =Merge=, =Read=, ...) and chosen from
1049 the item's state and your access. Rows have no header and no indent:
1050 a dim reference, a state glyph, the text, then dim facts joined by
1051 =·=. The glyphs are =✓= passed, =✗= failed or blocked, =◐= still
1052 going, =●= waiting on you, =○= closed or draft. A section cut short
1053 ends with =+n more= and the command for the rest. Below 80 columns the
1054 legend's groups stack; a suggested command is never cut, so it may run
1055 past the width;
1056- other =show= views with a title line, aligned fields, the body rendered
1057 from markdown or org, one line per event, and comments under a rule;
1058 a sub-table (labels, revisions, and the like) carries a section label
1059 line in both terminal and piped output; timestamps as
1060 =2026-09-23 23:26 UTC=. =wiki show= piped prints the page source
1061 verbatim; the rendered page is terminal-only;
1027- every list and show drawn as a screen: a header block of =Label:=
1028 lines (labels dim), the description or notes, sections titled =Title
1029 (n)= in bold blue, and a legend under a rule of the commands that
1030 apply now, grouped and chosen from the item's state and your access.
1031 Rows have no header (unless a column is a number or a size) and no
1032 indent: a dim reference, a state glyph, the text, then dim facts
1033 joined by =·=. The glyphs are =✓= passed, =✗= failed or blocked, =◐=
1034 still going, =●= waiting on you (your review requested, an issue
1035 assigned to you, an unread notification, a pending account, an
1036 overdue milestone, the session's own key), =○= closed or draft. A
1037 section cut short ends with =+n more= and the command for the rest.
1038 Below 80 columns the legend's groups stack; a suggested command is
1039 never cut, so it may run past the width. =dashboard= opens with what
1040 waits on you; for admins a =Problems= line counts background
1041 failures, and =admin stats= has the detail. =repo commit= prints its
1042 screen, then the diff. Secrets never appear on a screen, and a
1043 webhook URL shows its scheme and host only. =wiki show= piped prints
1044 the page source verbatim;
10621045- errors on stderr after a red =error:=, a mistyped flag with the flag
10631046 it is closest to (=did you mean --state?=), and a usage line wrapped
10641047 to the width between its bracketed groups, one alternative per line;
CHANGELOG.org +7
@@ -39,6 +39,13 @@ anything beyond "replace the binary and restart" is needed.
3939 milestone lists (repo and org), =org team list=/=show=. The session's
4040 own key leads with =●=; =pgp list= shows user IDs rather than their
4141 JSON; a webhook URL on screen is its scheme and host only.
42- The remaining commands at a terminal are screens (#319): saved
43 queries (and =issue list=/=mr list= with =--query=/=--q=), =search=
44 (a section per kind), =feed=, =mr revisions=, =issue templates=,
45 =build jobs=, =status list=, releases, snippets, wiki, =explore=,
46 =audit=, and the admin commands (=admin stats= lists the 20 largest
47 repositories). Every list and show is now a screen; the piped layout
48 is the only other one.
4249
4350* v1.41.0 — 2026-10-01
4451