bt login - Braintrust

bt login creates or updates a saved Braintrust login profile. A profile stores credentials and connection details, while organization and project context are selected separately. One profile can be used with every organization its credentials can access. After logging in, use bt switch to select your active organization and project. Use bt profiles to list, rename, or delete saved profiles. In an interactive terminal, bt login prompts you to choose OAuth or API key authentication. OAuth is selected by default.

bt login
bt login --oauth --profile work
bt login --refresh --profile work

Flags

Flag	Description
`--oauth`	Use OAuth login instead of API key login
`--refresh`	Immediately refresh credentials for a saved OAuth profile. OAuth credentials otherwise refresh automatically when needed
`--client-id CLIENT_ID`	OAuth client ID. Defaults to `bt_cli_<profile>`
`--no-browser`	For OAuth, do not open a browser automatically

bt login also accepts credential-related global flags, such as --profile, --api-url, and --app-url. It does not accept --org or --project; select those with bt switch.

Authentication

For the full credential resolution order, see Credential precedence.

⌘I

​Flags

​Authentication

Flags

Authentication