docs(readme): lead with the install script; Homebrew needs brew trust first - #183
Merged
Conversation
… first The documented install command has been failing for new users. Homebrew 6 refuses formulae from untrusted third-party taps and it's a hard error with no prompt: Refusing to load formula skzv/tap/ccmux from untrusted tap skzv/tap. Nothing here changed — Homebrew did. Confirmed require_tap_trust is on by default (6.0.5, no env set) and raise_untrusted! is unconditional, so every new user hits it. The fix is one extra command, but that costs the 'Setup is one command' line at the top, so lead with the install script (no tap, no gate) and give Homebrew its own block right under it with the trust step and the error it prevents. Verified the script installs v0.2.0 to ~/.local/bin. Co-Authored-By: Claude Fable 5 <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.
Same fix as ccmux-website#14, applied to the README.
The documented install command has been failing for new users. Homebrew 6 refuses formulae from untrusted third-party taps, and it's a hard error with no interactive prompt:
Nothing about ccmux changed — Homebrew did. I hit this while smoke-testing the v0.2.0 release and confirmed
require_tap_trustis on by default (Homebrew 6.0.5, no env vars) and thatraise_untrusted!raises unconditionally, so it isn't a niche configuration.The fix is one extra command (
brew trust --tap skzv/tap, once per machine) — but that would make "Setup is one command" in the intro false. So the README now leads with the install script, which has no tap and no trust gate and is a genuine one-liner, and Homebrew gets its own block underneath with the trust step and the exact error it prevents.Verified the script installs v0.2.0 to
~/.local/binand the binary runs.🤖 Generated with Claude Code