> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.astropods.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.astropods.com/_mcp/server.

# Top-level commands

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

## login

Authenticate with the Astro AI platform.

```bash
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](/authentication).

## logout

Clear stored credentials.

```bash
ast logout [--all]
```

`--all` clears credentials for all profiles.

## whoami

Display the currently authenticated user and active account.

```bash
ast whoami
```

## upgrade

Upgrade the CLI to the latest version.

```bash
ast upgrade [--force]
```

`--force` skips the version check and always downloads.

## docs

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

```bash
ast docs [category]
```

| Category          | Content                                             |
| ----------------- | --------------------------------------------------- |
| `agent` (default) | Agent development guide                             |
| `help`            | CLI help: installation, quick start, commands, spec |

## Next steps

* [Authentication](/authentication): how credentials and account scoping work
* [ast account](/cli/account): switch between the accounts you belong to