Skip to main content

Use the CLI

Log in and out from the CLI

Store interactive CLI authentication, recover from rejected credentials, and clear local sign-in state.

Sign in to allow the CLI to act on your accessible alterac.ai projects.

Sign in

alterac-ai login

Follow the prompts for your email, password, and any required two-factor or recovery-code challenge. When init needs authentication, it performs this sign-in as part of repository setup.

Recover from authentication errors

When a stored credential is missing or rejected, authenticated commands stop and tell you to log in; they do not unexpectedly start an interactive sign-in. Run alterac-ai login again, then repeat the command. Administrator-assisted authenticator recovery deliberately revokes every stored CLI credential, so log in again after completing or cancelling that recovery. If you cannot complete the authenticator challenge, use Fix account access before retrying the CLI.

Sign out

alterac-ai logout

This clears the stored CLI authentication from the device. If nothing is stored, it reports that no logout is needed. For exact command behavior, see the CLI command reference.