Install the CLI

Forge ships as a single CLI, aegis, which includes the map commands for onboarding and deploying. You install it once on your Mac.

One line

curl -fsSL https://get.mithran.cloud/aegis | sh

The script resolves the latest signed build, downloads the macOS package and its checksum, verifies the checksum and the code signature, checks notarization with Gatekeeper, and then installs. If any check fails it stops before touching your system. When it finishes:

aegis version

Reading the installer before you run it

Piping a script into a shell deserves a look first. You can read exactly what will run:

curl -fsSL https://get.mithran.cloud/aegis | less

The script does no magic: resolve release → download .pkg + SHA256SUMS → verify checksum, pkgutil --check-signature, spctl, and xcrun stapler validate → sudo installer. It installs nothing if the signature or checksum doesn't match.

If the install is paused

During preview, releases are sometimes paused. If that's the case the script tells you so and exits cleanly instead of installing a stale build. Try again later, or ask in your onboarding channel.

What it installs

• aegis: the CLI, including aegis setup, aegis codex, and aegis doctor.
• map: the onboarding and deploy commands (map onboard, map deploy, map doctor, map publish).

Next

Sign in with aegis setup.