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.

View resources across accounts

In the web app, the Blueprints, Knowledge Stores, and Agents pages show resources from every account you belong to.

Use the account filter to narrow the current page to one or more accounts. The filter is saved in the URL, so the view survives a reload and can be shared.

Filtering a page does not change your active account or the account used for write actions. Creation flows ask you to choose their destination account separately.

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.