diegopetrucci/tlh-gui/bb-account

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.