Skip to content

Sign in

aegis setup

aegis setup is the front door. It signs you into Mithran, opens the GitHub App install flow when you need it, and leaves you ready to build and deploy. Run it once per machine; run it again any time you want to re-check your state.

What it sets up

  • Your Mithran session. A browser window opens for sign-in. After that the CLI holds a session locally.
  • The GitHub App. If the Forge App isn't installed on the account you want to deploy from, setup hands you the install link. Use that link; Connect GitHub explains why it matters.
  • Codex (optional). If you build with aegis codex, setup makes sure your Codex login is in place.

Check your state any time

aegis doctor --json

doctor tells you what's ready and what isn't: session valid, GitHub App installed, repo granted. If something's missing it names the missing piece instead of failing vaguely.

Codex login

If you use aegis codex to build under the broker:

codex login

Log in once. After that aegis keeps the token fresh, so you won't hit the old "refresh token already used" loop or copy credentials between files by hand.

Next

Connect your GitHub account: Connect GitHub.