Installation
Installing Mago is a quick process with several options to suit your environment and preferences.
Shell Installer (macOS & Linux)
This is the recommended method for most macOS and Linux users. Our script automatically downloads the correct binary for your system and adds it to your path.
Using curl
curl --proto '=https' --tlsv1.2 -sSf https://carthage.software/mago.sh | bash
Using wget
wget -qO- https://carthage.software/mago.sh | bash
Package Managers
Homebrew (macOS)
If you're using Homebrew on macOS, you can install Mago with a single command:
brew install mago
You can later update Mago by running mago self-update
.
Composer (PHP Project)
To add Mago as a development dependency to your PHP project via Composer:
composer require --dev carthage-software/mago
Cargo (Rust)
If you have the Rust toolchain installed, you can install Mago directly from Crates.io:
cargo install mago
Manual Download
You can always download a pre-compiled binary directly from our GitHub Releases page. This is the recommended method for Windows and other systems not covered above.
- Navigate to the Mago Releases Page.
- Download the appropriate archive for your operating system (e.g.,
mago-x86_64-pc-windows-msvc.zip
for Windows). - Unzip the archive.
- Place the
mago.exe
(ormago
) executable in a directory that is part of your system'sPATH
environment variable.
Verify Installation
Once installed, you can verify that Mago is working correctly by checking its version:
mago --version