Skip to content

Update Homebrew cask install command#1189

Merged
steipete merged 3 commits into
steipete:mainfrom
SSakutaro:update-official-codexbar-cask
May 28, 2026
Merged

Update Homebrew cask install command#1189
steipete merged 3 commits into
steipete:mainfrom
SSakutaro:update-official-codexbar-cask

Conversation

@SSakutaro
Copy link
Copy Markdown

Summary

  • Update the README Homebrew cask command to use the official codexbar cask.

Context

Verification

  • git diff --check

Docs-only change; build/tests not run.

Copilot AI review requested due to automatic review settings May 27, 2026 11:19
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates installation instructions to use the standard Homebrew cask name instead of a custom tap, simplifying setup for users.

Changes:

  • Replace brew install --cask steipete/tap/codexbar with brew install --cask codexbar

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
### Homebrew
```bash
brew install --cask steipete/tap/codexbar
brew install --cask codexbar
@clawsweeper
Copy link
Copy Markdown

clawsweeper Bot commented May 27, 2026

Codex review: needs maintainer review before merge. Reviewed May 28, 2026, 10:50 AM ET / 14:50 UTC.

Summary
This PR changes the README Homebrew cask install command from the custom tap to brew install --cask codexbar.

Reproducibility: not applicable. this is a docs-only install-command update, not a reported runtime bug. The command target was checked against the current Homebrew cask metadata and upstream PR state.

Review metrics: none identified.

Merge readiness
Overall: 🐚 platinum hermit
Proof: 🦞 diamond lobster
Patch quality: 🐚 platinum hermit
Result: ready for maintainer review.

Overall follows the weaker of proof and patch quality, so missing proof can cap an otherwise strong patch.

Rank-up moves:

  • Optionally align the README badge and public site Homebrew copy in this PR or a follow-up so users see one install story.

Risk before merge

  • [P1] Adjacent public install surfaces still mention the custom tap or Apple Silicon-only Homebrew wording, so the README can be correct while the site and badge remain mixed until a follow-up aligns them.

Maintainer options:

  1. Decide the mitigation before merge
    Merge the README command update once maintainers are comfortable with the official Homebrew cask path, then handle broader site, badge, and in-app update-message alignment separately if desired.
  2. Pause or close
    Do not merge this PR until maintainers decide whether the risk is worth taking.

Next step before merge

  • No ClawSweeper repair lane is needed because the proposed patch is narrow, reviewable as-is, and has no blocking line-level defect.

Security
Cleared: The diff only changes a README install command and introduces no code execution, dependency, secret, CI, or supply-chain surface inside this repository.

Review details

Best possible solution:

Merge the README command update once maintainers are comfortable with the official Homebrew cask path, then handle broader site, badge, and in-app update-message alignment separately if desired.

Do we have a high-confidence way to reproduce the issue?

Not applicable: this is a docs-only install-command update, not a reported runtime bug. The command target was checked against the current Homebrew cask metadata and upstream PR state.

Is this the best way to solve the issue?

Yes for the README: after the upstream cask removed the Intel arch gate, replacing the custom tap command with the official cask is the narrow maintainable fix. Broader public-site and badge alignment can be a follow-up rather than a blocker for this one-line README change.

AGENTS.md: found and applied where relevant.

Codex review notes: model gpt-5.5, reasoning high; reviewed against 857f4fa4aa59.

Label changes

Label changes:

  • add P3: This is a low-risk documentation correction for the install command, with no runtime code changes.
  • add proof: sufficient: Contributor real behavior proof is sufficient. The contributor posted real Homebrew install verification for the official cask on Intel, and the current cask metadata confirms the removed arch gate.
  • add rating: 🐚 platinum hermit: Overall readiness is 🐚 platinum hermit; proof is 🦞 diamond lobster and patch quality is 🐚 platinum hermit.
  • add status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR. Sufficient (terminal): The contributor posted real Homebrew install verification for the official cask on Intel, and the current cask metadata confirms the removed arch gate.
  • remove rating: 🧂 unranked krab: Current PR rating is rating: 🐚 platinum hermit, so this older rating label is no longer current.
  • remove status: ⏳ waiting on author: Current PR status label is status: 👀 ready for maintainer look.

Label justifications:

  • P3: This is a low-risk documentation correction for the install command, with no runtime code changes.
  • rating: 🐚 platinum hermit: Overall readiness is 🐚 platinum hermit; proof is 🦞 diamond lobster and patch quality is 🐚 platinum hermit.
  • status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR. Sufficient (terminal): The contributor posted real Homebrew install verification for the official cask on Intel, and the current cask metadata confirms the removed arch gate.
  • proof: sufficient: Contributor real behavior proof is sufficient. The contributor posted real Homebrew install verification for the official cask on Intel, and the current cask metadata confirms the removed arch gate.
Evidence reviewed

What I checked:

  • README still uses custom tap on current main: Current README.md documents brew install --cask steipete/tap/codexbar, so the PR still has a useful docs change to make. (README.md:35, 857f4fa4aa59)
  • PR diff is narrow: The provided PR diff changes one README Homebrew command line from steipete/tap/codexbar to the official codexbar cask. (README.md:35, 08a7ef4a9a19)
  • Official cask is now universal-capable by metadata: Homebrew's current codexbar cask is version 0.30.1, uses CodexBar-macos-universal-0.30.1.zip, and depends only on macOS Sonoma, with no arch: :arm64 gate.
  • Upstream Intel blocker was removed: Homebrew/homebrew-cask pull request codexbar: allow Intel Macs Homebrew/homebrew-cask#266464 merged on 2026-05-27 and removed the depends_on arch: :arm64 line from Casks/c/codexbar.rb. (bbb9385d876a)
  • Adjacent public docs remain mixed: The static site still shows brew install --cask steipete/tap/codexbar and says Homebrew is Apple Silicon-only, so the broader install copy may need a separate alignment pass. (docs/index.html:82, 857f4fa4aa59)
  • Current docs ownership trail: git blame attributes the current README Homebrew install lines to Peter Steinberger's 14b2b25 release-docs commit. (README.md:35, 14b2b2524f7c)

Likely related people:

  • steipete: Current README install lines, static site Homebrew copy, and the in-app Homebrew update message are all blamed to Peter Steinberger's recent release-docs commit, and he asked for this re-review. (role: recent docs/release area contributor; confidence: high; commits: 14b2b2524f7c; files: README.md, docs/index.html, Sources/CodexBar/CodexbarApp.swift)
  • SSakutaro: Authored the upstream Homebrew cask PR that removed the Intel arch gate and provided Intel install verification, which directly affects whether this README command is safe. (role: external Homebrew cask fix contributor; confidence: medium; commits: 0e5f71d0197c, bbb9385d876a; files: Casks/c/codexbar.rb, README.md)
What the crustacean ranks mean
  • 🦀 challenger crab: rare, exceptional readiness with strong proof, clean implementation, and convincing validation.
  • 🦞 diamond lobster: very strong readiness with only minor maintainer review expected.
  • 🐚 platinum hermit: good normal PR, likely mergeable with ordinary maintainer review.
  • 🦐 gold shrimp: useful signal, but proof or patch confidence is still limited.
  • 🦪 silver shellfish: thin signal; proof, validation, or implementation needs work.
  • 🧂 unranked krab: not merge-ready because proof is missing/unusable or there are serious correctness or safety concerns.
  • 🌊 off-meta tidepool: rating does not apply to this item.

Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics.

How this review workflow works
  • ClawSweeper keeps one durable marker-backed review comment per issue or PR.
  • Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
  • A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
  • PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
  • Maintainers can also comment @clawsweeper review to request a fresh review only.
  • Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
  • Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
  • Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 08a7ef4a9a

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread README.md
### Homebrew
```bash
brew install --cask steipete/tap/codexbar
brew install --cask codexbar
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Preserve Intel Homebrew install path

For Intel users on macOS 14+, this new command resolves to the Homebrew/homebrew-cask codexbar cask, whose current metadata has depends_on arch: :arm64; Homebrew will reject the install before downloading the universal release. The previous tap cask does not declare that arm64-only constraint, so this README change removes the only Homebrew install path that works for Intel Macs despite the Requirements section still saying only macOS 14+ is needed.

Useful? React with 👍 / 👎.

@clawsweeper clawsweeper Bot added rating: 🧂 unranked krab Not merge-ready due to missing proof or serious correctness/safety concerns. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. labels May 27, 2026
@SSakutaro
Copy link
Copy Markdown
Author

@copilot
@clawsweeper
@chatgpt-codex-connector

I opened a Homebrew/homebrew-cask PR to fix that here:

Homebrew/homebrew-cask#266464

I also verified this on an Intel Mac:

  • HOMEBREW_NO_INSTALL_FROM_API=1 brew install --cask codexbar
  • file /Applications/CodexBar.app/Contents/MacOS/CodexBar
  • file /Applications/CodexBar.app/Contents/Helpers/CodexBarCLI
  • brew uninstall --cask codexbar

Both CodexBar and CodexBarCLI are universal binaries with x86_64 and arm64 slices, so once the Homebrew cask PR lands, brew install --cask codexbar should work for Intel Macs too.

@chatgpt-codex-connector
Copy link
Copy Markdown

To use Codex here, create a Codex account and connect to github.

@SSakutaro SSakutaro requested a review from Copilot May 27, 2026 12:41
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread README.md
### Homebrew
```bash
brew install --cask steipete/tap/codexbar
brew install --cask codexbar
@steipete
Copy link
Copy Markdown
Owner

@clawsweeper re-review

Upstream Homebrew blocker looks resolved now:

  • codexbar: allow Intel Macs Homebrew/homebrew-cask#266464 merged on 2026-05-27.
  • Current Homebrew cask uses CodexBar-macos-universal-0.30.1.zip.
  • Current cask depends only on macOS Sonoma and no longer has an arm64 arch gate.
  • Homebrew CI for that PR passed both macos-15-intel and macos-26 arm cask tests.

Please re-check whether this README command update is now mergeable, and whether any adjacent docs still need to distinguish GitHub Releases vs Homebrew.

@clawsweeper
Copy link
Copy Markdown

clawsweeper Bot commented May 28, 2026

🦞🧹
ClawSweeper re-review requested.

I asked ClawSweeper to review this item again.
Action: item re-review queued (workflow sweep.yml, event repository_dispatch).
Result: the existing ClawSweeper review comment will be edited in place when the review finishes.

Re-review progress:

@clawsweeper clawsweeper Bot added proof: sufficient Contributor real behavior proof is sufficient. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. P3 Low-risk cleanup, docs, polish, ergonomics, or speculative feature. and removed rating: 🧂 unranked krab Not merge-ready due to missing proof or serious correctness/safety concerns. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. labels May 28, 2026
@steipete steipete merged commit 1137192 into steipete:main May 28, 2026
1 check passed
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 666a77ec30

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md
### Homebrew
```bash
brew install --cask steipete/tap/codexbar
brew install --cask codexbar
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep the Homebrew upgrade path consistent

When users follow this new install command, Homebrew installs still disable Sparkle and the app’s About/update hint in Sources/CodexBar/CodexbarApp.swift:320 tells them to run brew upgrade --cask steipete/tap/codexbar. That no longer matches the cask they installed from this README path, so official-cask users are sent to a different tap/token for updates unless the in-app Homebrew guidance is updated at the same time.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low-risk cleanup, docs, polish, ergonomics, or speculative feature. proof: sufficient Contributor real behavior proof is sufficient. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants