macOS Package

Official

The macOS .pkg installer is the easiest way to install Berry on macOS. It's signed and notarized by Apple, so it just works—no Gatekeeper warnings.

Download

Download the latest .pkg from the GitHub Releases page.

Download macOS .pkg (Apple Silicon)Download macOS .pkg (Intel)View all macOS downloads

berry-X.Y.Z-arm64.pkg — Apple Silicon (M1/M2/M3)
berry-X.Y.Z-x86_64.pkg — Intel Macs

Install

Double-click the .pkg file and follow the prompts.

If you haven't downloaded it yet, grab the installer here: macOS .pkg download.

The installer places berry in /usr/local/bin and automatically runs berry integrate to register with Claude Code and Codex (if installed).

After Installing

# Authenticate (recommended)
berry auth login
# Headless/CI: berry auth set  (or: berry auth set --stdin)

# In each repo you want to use Berry:
berry init

# Reload MCP servers in your client

Verify Installation

berry version
berry doctor

Note: Unsigned Builds

If you download an unsigned .pkg (e.g., from a fork or CI artifact), macOS Gatekeeper may block it. You can bypass this with:

sudo xattr -rd com.apple.quarantine /path/to/berry.pkg

Only do this if you trust the source.