Install Aegis¶
Aegis is distributed as a global npm package. It installs the native Aegis CLI for macOS 15 or newer on Apple Silicon.
Check the installation:
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 noenginesrestriction, 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:
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.