CLI reference¶
The CLI ships as aegis, with the deploy-related commands under map. This page covers the commands you'll use day to day. Run any command with --help for the full flag list.
aegis setup¶
Signs you into Mithran and connects your GitHub account. Run once per machine; safe to re-run.
aegis doctor¶
Reports readiness: session, GitHub App install, repo grant. Add --json for machine-readable output.
codex login¶
Logs in to Codex for builds run with aegis codex. aegis keeps the token refreshed after this.
map onboard¶
Makes a repo deployable: registers it, scaffolds mithran.yaml and the deploy workflow, and sets the repo's Actions variables.
| Flag | Meaning |
|---|---|
--repo-dir <path> |
Where to write the scaffolded files (use . in a checkout). |
--installation-ref <ref> |
GitHub App installation to deploy under. |
--tenant-ref <ref> |
Tenant the app belongs to. |
--account-ref <ref> |
Account the app belongs to. |
--project-ref <ref> |
Project ref. Defaults to app:<repo-name>. |
--workflow <name> |
Workflow filename. Defaults to map-deploy.yml. |
A 409 means the GitHub App needs to be installed or granted on the repo; onboard prints the install link.
map deploy¶
Triggers a deploy of a ref through the workflow's manual dispatch.
map doctor¶
Confirms a repo is registered and deployable, beyond a bare count.
map publish¶
Points an app's clean public URL at a reviewed, succeeded version. Deploying a version and publishing it to the public host are separate steps, so you can deploy, check, then publish.
List an app's addressable versions and which one is published with map version listing; run map --help for the exact subcommand.
Global flags¶
| Flag | Meaning |
|---|---|
--endpoint <url> |
Control-plane endpoint (overrides the saved login). |
--token <token> |
Bearer token (use with --endpoint). |
--login-state <path> |
Path to the saved login file. |
--json |
Machine-readable output. |