> 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.

# Working with accounts

Every platform resource (blueprints, deployed agents, and secrets) belongs to an **account**. When you log in, you get a personal account. If you are a member of one or more organizations, those appear as additional accounts.

All CLI commands that interact with the platform operate on the **active account**. Switch accounts to work with a different set of resources.

## List accounts

Show all accounts you belong to:

```bash
ast account list
```

The active account is marked with a check. For example:

```
✓ alice (personal)
  my-org
  another-org
```

## Switch accounts

Switch interactively by running the command with no arguments:

```bash
ast account switch
```

Or switch directly by name:

```bash
ast account switch my-org
```

Use `-` to go back to the previously active account:

```bash
ast account switch -
```

## Switch accounts in the dashboard

The dashboard shows one account at a time. Pick an account from the selector beside the page title on **Agents**, **Blueprints**, **Knowledge**, or **Insights**. The selector sets the account for every page, not only the page you are on.

The dashboard and the CLI track their active accounts separately, so `ast account switch` does not change the account the dashboard shows.

## Check the active account

```bash
ast whoami
```

Prints the current user, email, active account, and token expiration.

## Account scoping

The following resources are scoped per account:

| Resource              | Command         |
| --------------------- | --------------- |
| Blueprints            | `ast blueprint` |
| Deployed agents       | `ast agent`     |
| Secrets and variables | `ast secrets`   |

Switching accounts with `ast account switch` takes effect immediately; the next command you run will use the new account.

Re-running `ast login` keeps the same active account you had before, unless you no longer have access to it (then the CLI uses your personal account). Use `ast login --account <name>` to pick a different account when logging in.