Skip to content

Install Aegis

Aegis is distributed as a global npm package. It installs the native Aegis CLI for macOS 15 or newer on Apple Silicon.

npm install --global @mithran-hq/aegis@0.9.4

Check the installation:

aegis version

The command prints the product name and version, 0.9.4 for this release.

Requirements

  • macOS 15 or newer on Apple Silicon (arm64). The launcher refuses other hosts and starts no native payload.
  • Node.js for npm, with support for ES modules and the node: built-in module prefix. The published package declares no engines restriction, so npm does not block an older Node.js; upgrade Node.js if the launcher fails to start.
  • A writable npm global prefix. Do not run npm with sudo.

What the launcher does

@mithran-hq/aegis is a launcher, not the CLI. It installs the native companion @mithran-hq/aegis-darwin-arm64 at the same version, verifies the companion's package identity, release manifest, payload checksum and Mach-O architecture, then runs it with your arguments and returns its exit status.

When the host is unsupported, the companion is missing, or the payload does not verify, the launcher prints aegis: <reason> and exits nonzero. Install the same version again if the companion did not land:

npm install --global @mithran-hq/aegis@0.9.4

Installer packages

The npm launcher is the supported installation for this CLI. A signed macOS .pkg is published for the separate full product, which also provides the protected agent runtime; it is not required here and is not the recommended path for account, gateway or Forge work. Run agents describes that boundary.

Next

Sign in with account setup, then follow Quickstart to configure an agent and deploy an application.