Conversation
The `gx --help` and `gx` (no-args) output used to render every CLI command as one flat 20-row list, so a first-time user had to scan the entire catalog to find the intended "install, setup, first branch" sequence. Rework the help surface into a grouped catalog with a Quickstart block so the expected bootstrap path is always visible before the exhaustive command reference: - Add `CLI_COMMAND_GROUPS` (Setup & health / Branch workflow / Coordination / Agents & reports / Meta) and `CLI_QUICKSTART_STEPS` in `src/context.js` as the source of truth, and derive the existing flat `CLI_COMMAND_DESCRIPTIONS` export from those groups so other callers keep working. - Teach `src/output/index.js` to render the grouped catalog in both the plain (`NO_COLOR=1` / non-TTY) and colored tree-pipe layouts used by `usage()` (`gx --help`) and `printToolLogsSummary()` (`gx` with no arguments). A new QUICKSTART section shows the three-step bootstrap (`gx setup` → `gx branch start` → `gx branch finish --via-pr --wait-for-merge --cleanup`). Bump the package version to 7.0.28 so this CLI UX change can ship on a fresh npm publish; README release notes document the redesign under the v7.0.28 heading (metadata tests require a matching heading to exist). Verified locally with `node --test test/metadata.test.js test/output.test.js test/cli-args-dispatch.test.js` (35 pass, 0 new failures; the single remaining failure in the broader suite is the pre-existing vscode-active-agents extension drift, present before this change). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Before:
```
COMMANDS
status Show GitGuardex CLI + service health ...
setup Install, repair, and verify guardrails ...
doctor Repair drift + verify ...
branch CLI-owned branch workflow surface ...
(… 16 more flat rows …)
```
A first-time user had to scan the whole 20-row list to figure out the intended "install → setup → first branch" sequence. This restructures the help surface into a grouped catalog with a Quickstart block that makes the bootstrap path visible up-front.
After (
gx --helporgxwith no args):Changes
Test plan
Known unrelated failures
🤖 Generated with Claude Code