Skip to content

Add Homebrew install for macOS - #8

Merged
asweeney86 merged 1 commit into
mainfrom
homebrew-cask
Nov 3, 2026
Merged

asweeney86 merged 1 commit into
mainfrom
homebrew-cask

Conversation

@asweeney86

Copy link
Copy Markdown
Owner

Summary

Lorimer can now be installed on macOS with one command:

brew install --cask asweeney86/tap/lorimer

The cask installs Lorimer.app and puts lorimer-cli on PATH.

  • Release: the macOS job now builds lorimer-cli as a universal binary and bundles it at Lorimer.app/Contents/MacOS/lorimer-cli. The job fails if the bundled CLI is missing.
  • Cask: generated from packaging/homebrew/lorimer.rb.in by scripts/render-cask.sh. It uses postflight_steps (Homebrew 7) to remove the quarantine flag, because the app is not notarized yet.
  • Tap automation: the new homebrew.yml runs when a release is published. It renders the cask with the version and checksum, pushes it to asweeney86/homebrew-tap, and then installs it on a clean macOS runner to check it works. It can also be re-run by hand with a tag.
  • CI: a new job renders the cask and runs brew style on it inside a tap.
  • Docs: the README opens with a Get started section and lists Homebrew first under Install. Also new: a Releasing section in CONTRIBUTING.md and CHANGELOG.md.

Before the first brew release

  1. Create the public repo asweeney86/homebrew-tap.
  2. Add a fine-grained token with Contents read/write on that repo as the HOMEBREW_TAP_TOKEN secret here.
  3. Publish a release built from this branch. The v0.1.0 draft predates this change and has no lorimer-cli in the app.

Testing

  • Installed the rendered cask from a local tap. The app installed, lorimer-cli was on PATH and ran a scan, and uninstalling removed both.
  • Quarantine: without the postflight step the app kept com.apple.quarantine; with it the flag was gone.
  • brew style reports no problems with the cask, and actionlint passes on all workflows.
  • cargo fmt --check, cargo clippy --workspace --all-targets -D warnings and cargo test --workspace pass.
  • The tap update workflow can only be exercised by a real published release.

Lorimer can now be installed with one command:

    brew install --cask asweeney86/tap/lorimer

The cask installs Lorimer.app and links lorimer-cli onto PATH. To make
that possible, the macOS release now builds lorimer-cli as a universal
binary and ships it inside the app bundle at Contents/MacOS/lorimer-cli.
The release job fails if the bundled CLI is missing.

The cask is generated from packaging/homebrew/lorimer.rb.in by
scripts/render-cask.sh. A new Homebrew workflow runs when a release is
published (not when the tag is pushed, since draft assets are not
downloadable). It renders the cask with the new version and checksum,
pushes it to asweeney86/homebrew-tap, and then installs it on a clean
macOS runner to confirm it works. CI lints the rendered cask with
brew style on every pull request.

Because the app is not notarized yet, the cask removes the quarantine
flag after installing so the first launch is not blocked.

The README now opens with a Get started section and lists Homebrew first
under Install. CONTRIBUTING.md documents the release steps and the
HOMEBREW_TAP_TOKEN secret, and CHANGELOG.md is added.
@asweeney86
asweeney86 merged commit a32e9c2 into main Nov 3, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants