From a5685e7a692d77e969bb2d97586d00940d63b333 Mon Sep 17 00:00:00 2001 From: Shijie Rao Date: Mon, 20 Oct 2025 09:45:15 -0700 Subject: [PATCH] Document Homebrew cask release process --- docs/release_management.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/release_management.md b/docs/release_management.md index d2b3264554..eb9bb70c02 100644 --- a/docs/release_management.md +++ b/docs/release_management.md @@ -4,7 +4,7 @@ Currently, we made Codex binaries available in three places: - GitHub Releases https://github.com/openai/codex/releases/ - `@openai/codex` on npm: https://www.npmjs.com/package/@openai/codex -- `codex` on Homebrew: https://formulae.brew.sh/formula/codex +- `codex` on Homebrew Cask: https://formulae.brew.sh/cask/codex # Cutting a Release @@ -34,14 +34,14 @@ The GitHub Action is responsible for publishing to npm. ## Publishing to Homebrew -For Homebrew, we are properly set up with their automation system, so every few hours or so it will check our GitHub repo to see if there is a new release. When it finds one, it will put up a PR to create the equivalent Homebrew release, which entails building Codex CLI from source on various versions of macOS. +For Homebrew, we ship Codex as a cask. Homebrew's automation system checks our GitHub repo every few hours for a new release and will open a PR to update the cask with the latest binary. Inevitably, you just have to refresh this page periodically to see if the release has been picked up by their automation system: -https://github.com/Homebrew/homebrew-core/pulls?q=%3Apr+codex +https://github.com/Homebrew/homebrew-cask/pulls?q=%3Apr+codex Once everything builds, a Homebrew admin has to approve the PR. Again, the whole process takes several hours and we don't have total control over it, but it seems to work pretty well. -For reference, our Homebrew formula lives at: +For reference, our Homebrew cask lives at: -https://github.com/Homebrew/homebrew-core/blob/main/Formula/c/codex.rb +https://github.com/Homebrew/homebrew-cask/blob/main/Casks/c/codex.rb