/bb-account

name: bb-account
description: "Sign this bb in to or out of its getbb.app account with bb account, and check which account remote access and hosted services use."

bb account

The builtin bb account plugin links this bb server to a getbb.app account and holds the server credential. Remote access (`bb connect`) and hosted services reach getbb.app through it; they never see the credential.

Check the account

`bb account status [--json]` prints the signed-in name, GitHub login, handle, and this server's label and URL, or `Not signed in`. A bb that holds a pairing but couldn't load its account yet says so; it keeps retrying, and remote access and hosted services start once it succeeds. With `--json` it prints `{state, revision, account, login}`: `state` is `signed-in`, `signed-out`, or `profile-pending`, and `login` is the pending browser sign-in, if any.

Sign in

• `bb account login [--json]` starts a browser sign-in. It prints a

`https://getbb.app/link?code=XXXX-XXXX` link and the code, then returns. Open the link on any device, sign in with GitHub, claim a handle if asked, and approve. bb finishes signing in on its own; the code expires after 10 minutes.

• `bb account login --wait [--json]` waits for that sign-in to be approved,

denied, or expire, and exits non-zero unless it signed in.

• `bb account login --code XXXX-XXXX [--json]` pairs with a one-time code from

the getbb.app dashboard. `bb connect --code <code>` is an alias.

• `--base-url <url>` points sign-in at `https://getbb.app` or

`https://vibecodethis.site` (staging); a development build also accepts `http://bb.localhost:<port>`. Any other origin is refused. In a source checkout, `pnpm dev` sets `BB_DEV_CONNECT_BASE_URL` so sign-in uses that worktree's local Cloud.

Signing in again replaces the account this bb is signed in to, and revokes the previous server on getbb.app when the new sign-in is for a different one. Starting a new sign-in cancels one that is still waiting for approval.

Sign out

`bb account logout [--json]` revokes this server's credential on getbb.app, forgets it locally, and cancels a sign-in still waiting for approval. Remote access and hosted services stop until you sign in again. If getbb.app can't be reached, bb still signs out locally and says the server wasn't revoked; remove it from the getbb.app dashboard. `--json` prints `{revocation, status}`. To stop remote access but stay signed in, use `bb connect off`.

Settings → Plugins → bb account shows the same account, a Sign in button that opens getbb.app, a pairing-code field, and Sign out.

Imported servers

A server imported with `bb server import` starts with bb account and bb connect held off, so a copy can't use the original server's account. Stop the original server, run `bb server allow-connect`, then restart bb.