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:

$
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:

$
ast account switch

Or switch directly by name:

$
ast account switch my-org

Use - to go back to the previously active account:

$
ast account switch -

Check the active account

$
ast whoami

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

Account scoping

The following resources are scoped per account:

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.