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 -

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

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.