Add REFERENCE.md with auto-generated CLI help documentation - #361
Merged
Conversation
REFERENCE.md collects the `--help` output of every mcpc command, in the order the commands are listed by `mcpc --help`. It is captured from the built CLI by scripts/generate-reference.mjs, the same way the Usage block in README.md is, so it can never drift into hand-written prose. - `pnpm run build:reference` regenerates it; `pnpm run check:reference` fails when the committed file no longer matches the CLI - CI runs the check, and the release workflow regenerates and commits the file alongside README.md - Command order follows `mcpc --help`; anything the overview does not list (e.g. the session-level `close`/`restart` screens) is still included Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TwS6auWuztE5mdLGuDqNy9
jancurn
pushed a commit
that referenced
this pull request
Aug 2, 2026
Refs #361 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HYhygKZPPuddYpG67y7c1N
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
3 participants
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.
Adds
REFERENCE.md: the--helpoutput of every command, in the ordermcpc --helplists them. It's captured from the built CLI byscripts/generate-reference.mjs, the same way the Usage block in README.md is, so it can't drift into hand-written prose.pnpm run build:referenceregenerates it,pnpm run check:referencefails when it no longer matches the CLImcpc --helpitself — nothing hardcoded — and commands the overview omits (the session-levelclose/restartscreens) are still includedMCPC_HOME_DIR, and without the version-pinnedFull docs:line, so the output is deterministicNo originating issue — requested directly; happy to open one if you'd like a tracking artifact.
https://claude.ai/code/session_01TwS6auWuztE5mdLGuDqNy9