Installation

Homebrew (recommended)

brew tap ivantokar/homebrew-tap
brew install ivantokar/tap/mage
mage --help

Use the fully qualified formula name. mage also exists in Homebrew core as the Go Mage build tool, so brew install mage installs a different CLI.

If you already installed the Homebrew core formula, remove it first:

brew uninstall mage
brew install ivantokar/tap/mage

If Homebrew reports that another mage executable is earlier in your PATH, remove or rename the old binary before using the Homebrew-installed one:

rm ~/.local/bin/mage
hash -r
mage --help

The Homebrew formula installs a prebuilt Apple Silicon bottle. If you see an Xcode or Command Line Tools version warning on macOS beta releases, make sure you are installing ivantokar/tap/mage, not building from source.

Build from source

git clone git@github.com:ivantokar/mage.git
cd mage
swift build -c release
cp .build/release/Mage /usr/local/bin/mage

Verify

mage --help

Requirements

• macOS 13+
• Apple Silicon for the Homebrew bottle
• Swift 5.10+ toolchain only when building from source