Search documentation

Search the Fumadocs-backed documentation index.

ax auth

Sign in and manage CLI credentials.

CommandUse
auth loginSign in with a browser device code or an API key.
auth statusShow the identity the platform resolves for you.
auth connectRedeem a one-time code from the AX MCP connector.
auth logoutForget the local credentials file.

auth whoami is still accepted as an alias for auth status.

auth login

Sign in with a browser device code, or pass an API key directly.

ax auth login
Argument / flagWhat it does
--token <api-key>Use this API key instead of the interactive prompt (for CI and scripts).
--org <org-id-or-slug>Select the org when the key belongs to several.
--no-browserPrint the verification URL instead of opening a browser.

Examples:

# CI: sign in non-interactively with an API key
ax auth login --token "$AX_API_KEY"

# SSH session: print the verification URL instead of opening a browser
ax auth login --no-browser

auth status

Show the identity and org the platform resolves for your saved credentials.

ax auth status [--json]

auth connect

Sign the CLI in by redeeming a one-time code minted by the AX MCP connector (the cli_auth flow an agent starts for you).

ax auth connect --code <CODE>
Argument / flagWhat it does
--code <code>Required. One-time code returned by the MCP cli_auth.start tool.

auth logout

Forget the local credentials file. This does not revoke the key; use ax api-key revoke for that.

ax auth logout