braid docs

braid auth

Manage authentication for the braid CLI.

Subcommands

SubcommandDescription
loginAuthenticate with braid via browser login or API key
statusShow current authentication status
logoutRemove stored API key

Commands

braid auth login

Authenticate via browser login by default, or use a token for non-interactive environments.

braid auth login

Opens a browser window for device-flow authentication. Once approved, your local auth session is stored for future CLI commands.

Options

OptionDescription
--token <token>Token for non-interactive login (skips device flow)
--timeout <seconds>Device flow timeout (default: 300)
--no-scopeSkip scope setup after login
-s, --server <url>Custom server URL

Non-interactive login

If browser login is not available, pass a token directly:

braid auth login --token brk_your_api_key_here

braid auth status

Show current authentication status.

braid auth status

braid auth logout

Remove the stored API key.

braid auth logout