Update Homebrew install docs for Homebrew 6 tap trust - #22
Merged
Merged
Conversation
3 tasks
jrothrock
approved these changes
Sep 10, 2026
quinnmil
force-pushed
the
20-homebrew-tap-trust
branch
from
September 10, 2026 21:09
19625ab to
3a80c9e
Compare
Homebrew 6 requires third-party taps to be explicitly trusted. The fully qualified `brew install scoutapp/tap/scout-cli` still works (it trusts only the scout-cli formula), so it stays the primary command. Document the fix for users upgrading from Homebrew 5 who see the "taps are not trusted" warning (`brew trust --formula scoutapp/tap/scout-cli`), and add a Brewfile / `brew bundle` form with `trusted: true`. Closes #20 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BK3fzED9ksTWsvoPfsEwpS
quinnmil
force-pushed
the
20-homebrew-tap-trust
branch
from
September 10, 2026 21:15
3a80c9e to
457b6f6
Compare
This was referenced Sep 10, 2026
Closed
Merged
This was referenced Sep 14, 2026
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.
Closes #20
Summary
Homebrew 6.0.0 introduced Tap Trust: third-party taps like
scoutapp/tapmust be explicitly trusted before Homebrew will load their formulae. This updates the README Homebrew section and adds a CHANGELOG entry.Changes
brew install scoutapp/tap/scout-clias the primary install command, with a note that the fully qualified name trusts only thescout-cliformula.brew upgradeshows the "taps are not trusted" warning, runbrew trust --formula scoutapp/tap/scout-cli(orbrew trust scoutapp/tapfor the whole tap), thenbrew upgrade scout-cli.brew bundle install --file=-heredoc form usingbrew "scoutapp/tap/scout-cli", trusted: true, with a one-line mention oftap "scoutapp/tap", trusted: truefor whole-tap trust.## Pending→### Changedentry.What was verified
brew upgrade --dry-run scoutapp/tap/scout-cliprints==> Trusted formula scoutapp/tap/scout-cli, so the existing one-liner works on Homebrew 6.scoutapp/tapunder Homebrew 5 and then runbrew upgrade, or whobrew tapand then install by short name.brew bundlehonourstrusted: trueontap,brew, andcaskentries; the README snippet parses cleanly viabrew bundle list --file=-.README.md. Thescoutapp/homebrew-taprepo has no README, so nothing to change there. The 0.1.0 CHANGELOG mention ofscoutapp/tapis in a versioned section and was left untouched.Deviation from the issue's proposal
The issue suggested making a whole-tap
trusted: trueBrewfile the primary instruction. Since fully qualified installs have auto-trusted the formula since 6.0.0, the one-liner stays primary, and the Brewfile example trusts the formula rather than the whole tap, per Homebrew's guidance to "prefer trusting the specific formula, cask or command you need." Whole-tap trust is still documented as the alternative.Scope from #20
brew install scoutapp/tap/scout-cli(none found besides README)🤖 Generated with Claude Code
https://claude.ai/code/session_01BK3fzED9ksTWsvoPfsEwpS