Top-level commands

The ast commands that stand on their own, without a subcommand group.

login

Authenticate with the Astro AI platform.

ast login [--no-browser] [--account <name>]

--no-browser prints the verification URL instead of opening it. --account switches to the named account after login. Re-login restores your last active account unless you pass --account. Credentials are stored in the system keyring or ~/.ast/credentials.json. See Authentication.

logout

Clear stored credentials.

ast logout [--all]

--all clears credentials for all profiles.

whoami

Display the currently authenticated user and active account.

ast whoami

upgrade

Upgrade the CLI to the latest version.

ast upgrade [--force]

--force skips the version check and always downloads.

docs

Display Astro AI documentation in the terminal. Alias: ast doc.

ast docs [category]

Next steps

• Authentication: how credentials and account scoping work
• ast account: switch between the accounts you belong to