Skip to content

Commit 929e471

Browse files
docs(grok): clarify Homebrew ownership and manual updates
1 parent 3ba7d70 commit 929e471

2 files changed

Lines changed: 3 additions & 2 deletions

File tree

‎docs/internals/providers.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,8 @@ symlinks there. Volta is proven by its `volta-shim` link plus the package's imag
8989
nothing is proven, the provider's own updater (`claude update`, `codex update`, `opencode upgrade`,
9090
`pi update --self`, `grok update`) runs instead, because each one detects its installer itself;
9191
the runner's version check catches an updater that exits 0 without updating. Mise installs stay
92-
manual-only because their version is pinned in mise's config. npm updates pin `--prefix` because the
92+
manual-only because their version is pinned in mise's config. A Grok cask whose Homebrew prefix
93+
cannot be verified also stays manual-only: `grok update` would install a second copy. npm updates pin `--prefix` because the
9394
`npm` on `PATH` can belong to a different Node than the one that owns the provider. Homebrew
9495
compares against `brew info` since casks trail npm by hours; native installs share npm's version
9596
train, so the registry stays authoritative for them.

‎packages/provider-grok/src/server/driver.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ const GROK_NPM_PACKAGE = "@xai-official/grok";
5353
// `grok update` finds the installer that owns the binary itself, so the
5454
// resolved executable is its own updater. It installs under `GROK_HOME`, so it
5555
// runs with the instance's environment. The exception is a Homebrew cask
56-
// (`grok-build`), which brew upgrades and versions: `grok update` would install
56+
// (normally `grok-build`), which brew upgrades and versions: `grok update` would install
5757
// a second copy beside it, so a cask its brew cannot vouch for stays manual.
5858
const UPDATE: ProviderMaintenanceCapabilitiesResolver = {
5959
resolve: Effect.fn("resolveGrokMaintenance")(function* (context) {

0 commit comments

Comments
 (0)