OpenRouter Homebrew Tap

This repository contains Homebrew formulae for OpenRouter tools.

Homebrew exposes this repository as the OpenRouterLabs/tap tap.

Repository layout

• Formula/ contains the Homebrew formulae.
• templates/ contains the binary formula template.
• scripts/new-formula creates a formula from release metadata.
• scripts/check checks the repository and its formulae.
• scripts/update-ori reconciles the Ori formula with the latest stable release.
• .github/workflows/update-ori.yml opens or updates the Ori formula pull request.

Requirements

Install Homebrew and Ruby before you change this repository.

Create a formula

Build two macOS release archives before you run this command. Each archive must contain one executable at its root.

Run this command with immutable HTTPS URLs and SHA-256 checksums:

scripts/new-formula \
  <name> \
  <version> \
  <arm64-url> \
  <arm64-sha256> \
  <x86_64-url> \
  <x86_64-sha256>

The command creates Formula/<name>.rb. Edit the description and homepage after the command completes.

The generated test expects <name> --version to print the release version. Change the test if the tool uses a different command.

Update Ori

The Update Ori workflow listens for the ori-released repository dispatch. It also runs each hour and supports manual runs.

Each run reads the latest stable release from OpenRouterLabs/ori-releases. The workflow does not trust the dispatch payload as release state.

If the formula is stale, the workflow performs these steps:

1. Update the version, immutable URLs, and four checksums in Formula/ori.rb.
2. Run scripts/check.
3. Open or update the automation/update-ori pull request.

The workflow requires these Actions secrets:

• ORI_HOMEBREW_GH_APP_CLIENT_ID
• ORI_HOMEBREW_GH_APP_PRIVATE_KEY

Make these secrets available to this repository. Install the Ori Homebrew Updater App on OpenRouterLabs/homebrew-tap with these repository permissions:

• Contents: read and write
• Pull requests: read and write

Run the updater locally:

scripts/update-ori
scripts/check

The updater stops if release metadata is incomplete or the formula has an unexpected structure.

Check the tap

Run all local checks:

scripts/check

The check stops if a formula has invalid Ruby syntax or Homebrew style errors.

If this checkout is registered as OpenRouterLabs/tap, the check also runs a strict Homebrew audit.

Test a formula locally

Install the formula from its file:

brew install --formula ./Formula/<name>.rb
brew test ./Formula/<name>.rb

Remove the local installation after the test:

brew uninstall <name>

Installation

Add the tap and install a formula:

brew tap OpenRouterLabs/tap
brew install <name>

Release checklist

1. Publish immutable ARM64 and x86-64 macOS archives.
2. Calculate a SHA-256 checksum for each archive.
3. Create or update the formula.
4. Run scripts/check.
5. Install and test the formula on both macOS architectures.
6. Get approval from the DevEx team.
7. Merge the formula change.

Security

A Homebrew formula runs code on user computers. Treat each formula change as a privileged software-distribution change.

Do not put tokens, signed URLs, or other secrets in a formula. Use immutable artifact URLs and pinned checksums.