docs: sync CLAUDE.md with the current command surface - #27
Merged
Conversation
CLAUDE.md had drifted since `docs open` and two-tier help landed: - error boundary listed four typed error classes; there are nine - `config.ts` was described as the only reader of process.env, but NO_COLOR / TABBREW_DEBUG / CLAUDE_CONFIG_DIR are read at their use site - `tabs` was called config-free, though serve/push read config.serve - `docs open` and `docs list`'s OSC 8 clickable titles were undocumented - registry.ts said nothing about `help --all`, `hidden`, or the env tables - Configuration table missed TABBREW_SERVE_PORT / TABBREW_TABS_PATH / CLAUDE_CONFIG_DIR; layout missed table.test.ts Co-Authored-By: Claude Opus 4.8 (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
1 participant
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.
CLAUDE.mdhad drifted from the code sincedocs openand two-tier help landed. Documentation only — no source changes.What was wrong
UpdateError,TabsInputError,ServeError,TabsPushError, andUsageErrorwere all missing. Added the rule that a new class must be registered in the boundary'sknownlist, since an unlisted one silently degrades to the generic message.config.ts— claimed nothing else readsprocess.envfor configuration. Not true:NO_COLOR(ui.ts),TABBREW_DEBUG(index.ts), andCLAUDE_CONFIG_DIR(agents.ts) are read at their use site. Named them as deliberate exceptions rather than weakening the rule.tabssubsystem — called offline, "touches neitherconfignor the network."serve/pushreadconfig.serve. Reworded to "never talks to the TabBrew server," which is the invariant that actually matters.docs open <id>— entirely undocumented. Added the list-and-find approach (there is no per-id endpoint), the sharedviewUrl()local-vs-cloud split, and the relationship todocs list's OSC 8 clickable titles, for whichdocs openis the fallback.registry.ts— no mention of two-tier help (help --all,hidden,COMMON_ENV/DEV_ENV). Also flagged that the env tables live in three places with no generator.TABBREW_SERVE_PORT,TABBREW_TABS_PATH,CLAUDE_CONFIG_DIR.table.test.ts;docs.tsnow split out with its subcommands.Releasing, Build, and the cross-repo notes were checked and left alone — they still match reality (v0.5.3, Bun pinned at 1.3.5 in both workflows).
🤖 Generated with Claude Code