Command Reference

brainbase team

List the organizations and teams you belong to. Every agent lives inside a team, so this is where the --team <id> value used by agent create and agent list comes from. The command is read-only.

brainbase team list

Print every organization you're a member of, each with its teams and their ids. brainbase teams list is accepted as an alias. Pass --org to narrow the output to a single organization.

bash

brainbase team list
brainbase team list --org <org-id-or-slug>
brainbase team list --json

text

Brainbase Labs  brainbase-labs-71eef388
  General       75ee7d62-e528-499c-a91f-5c4c268c2bd9
  Engineering   5374e9c1-e3f7-40e5-9a11-0cc1c5722009

Grant Writing Team  grant-writing-team-8bf6c897
  General       5bc1e87a-9f22-4aba-9047-e05db58b4ce8

Flag	Description
`--org <id-or-slug>`	Limit the output to one organization.
`--json`	Emit `[{ org, teams, error? }]` and nothing else.

An organization whose teams can't be loaded does not blank the listing. It is reported in place — and on stderr under --json, so stdout stays parseable — and carries an error field in the JSON, so a short result is never mistaken for an organization with no teams. The command only exits non-zero when no organization could be read at all.

Teams are created in the web app

The CLI reads teams but does not create them, with one exception: brainbase agent create offers "+ Create a new team" in its interactive picker. Everywhere else, create the team in the web app first.