Skip to content

Commit 836f867

Browse files
committed
docs: drop Homebrew tap-trust steps now that brew 6.0.2 auto-trusts
1 parent 9e1c142 commit 836f867

2 files changed

Lines changed: 3 additions & 7 deletions

File tree

DISTRIBUTION.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ This document covers how `dci` releases are built, published, and distributed ac
77
| Channel | Install command |
88
|------------------|---------------------------------------------------------------------------------|
99
| GitHub Releases | Download from [Releases](https://github.com/doitintl/dci-cli/releases/latest) |
10-
| Homebrew (macOS) | `brew trust doitintl/dci-cli && brew install doitintl/dci-cli/dci` |
10+
| Homebrew (macOS) | `brew install doitintl/dci-cli/dci` |
1111
| Scoop (Windows) | `scoop bucket add doitintl https://github.com/doitintl/dci-cli && scoop install dci` |
1212
| WinGet (Windows) | `winget install DoiT.dci` |
1313
| Linux (.deb) | `sudo dpkg -i dci_*_linux_amd64.deb` |
@@ -82,7 +82,7 @@ To re-release: fix the issue, tag a new patch version, and push.
8282
| Homebrew/Scoop commit fails with permission error | Ensure `permissions: contents: write` is set in the workflow |
8383
| Homebrew/Scoop commit blocked by branch protection | Add `github-actions[bot]` to the bypass list |
8484
| Post-release Homebrew install fails | Confirm release assets exist, then re-run `sync-manifests` |
85-
| `brew install` fails with an opaque `sandbox-exec ... build.rb exited with 1` backtrace | Homebrew 6+ refuses to load formulae from untrusted taps; the real warning scrolls past before the error. Run `brew trust doitintl/dci-cli` and retry. |
85+
| `brew install` fails with an opaque `sandbox-exec ... build.rb exited with 1` backtrace | A Homebrew 6.0.0–6.0.1 bug blocked installs from third-party taps. Run `brew update` to get 6.0.2+ (which auto-trusts fully-qualified installs) and retry. |
8686
| `release.yml` stuck queued | Another release for the same tag is in progress — wait or cancel it |
8787
| WinGet PR submission skipped | `WINGET_GH_PAT` secret is not configured — add a PAT with `public_repo` scope |
8888
| WinGet PR fails validation | Check [microsoft/winget-pkgs validation policies](https://github.com/microsoft/winget-pkgs/blob/master/doc/README.md) |
@@ -99,4 +99,3 @@ To re-release: fix the issue, tag a new patch version, and push.
9999
- **Windows ARM64** is excluded due to a missing cross-compiler in `goreleaser-cross` ([goreleaser-cross#117](https://github.com/goreleaser/goreleaser-cross/issues/117)).
100100
- **WinGet** submissions are automated via `sync-manifests.yml`, which opens a PR to [microsoft/winget-pkgs](https://github.com/microsoft/winget-pkgs) on each release. This requires a `WINGET_GH_PAT` secret (a GitHub PAT with `public_repo` scope) and a fork of `winget-pkgs` (currently `apgiorgi/winget-pkgs`). Microsoft's automated validation runs on each PR — approval is typically within hours.
101101
- **Homebrew tap** relies on a GitHub redirect from `doitintl/homebrew-dci-cli` to this repo. Do not create a repo named `homebrew-dci-cli` in the org.
102-
- **Homebrew 6 tap trust**: because of the redirect above, Homebrew records the tap with a non-canonical remote (`github.com/doitintl/dci-cli` instead of the `homebrew-dci-cli` URL implied by the tap name). Homebrew treats such taps as "custom remote" and disables both per-formula trust and the auto-trust normally granted by fully-qualified installs — so `brew install doitintl/dci-cli/dci` alone fails on Homebrew 6+, and users must run `brew trust doitintl/dci-cli` (whole-tap trust) first. Creating a real `homebrew-dci-cli` tap repo would restore canonical-remote behavior, at the cost of maintaining a second repo.

README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,7 @@
77
## Installation
88

99
```bash
10-
# macOS (Homebrew) — the `brew trust` step is required once on Homebrew 6+
11-
brew trust doitintl/dci-cli
10+
# macOS (Homebrew)
1211
brew install doitintl/dci-cli/dci
1312

1413
# Windows (WinGet)
@@ -133,8 +132,6 @@ winget upgrade DoiT.dci
133132
scoop update dci
134133
```
135134

136-
> **Note (Homebrew 6+):** if `dci` stops appearing in `brew upgrade`, the tap is untrusted and Homebrew skips it silently. Run `brew trust doitintl/dci-cli` once to fix it.
137-
138135
## Authentication
139136

140137
By default, `dci` authenticates interactively via the DoiT Console (OAuth). For CI pipelines and non-interactive environments, set the `DCI_API_KEY` environment variable:

0 commit comments

Comments
 (0)