version: "1.0.0" name: bb-cloud-ai description: "Check, turn off, or troubleshoot bb cloud, the hosted service that writes thread titles and commit messages and transcribes voice input for signed-in bb accounts."

bb cloud AI

bb cloud is the bb AI service from the bb-ai plugin. It writes thread titles (branch names follow the title) and commit messages and transcribes voice input for a signed-in bb account, within a daily spend limit per account.

bb cloud is on by default for a signed-in account. A user who turned it off stays off across restarts and upgrades. While off, it reports not ready, Automatic skips it, and nothing is sent to getbb.app. It has no settings page.

• bb ai off [--json] turns bb cloud off and keeps the bb account signed in;

bb ai on [--json] turns it back on. Only turn it on when the user asks: it sends prompt text, diffs, and voice recordings off the machine. Disabling the bb-ai plugin in Settings → Plugins also stops it.

• bb ai status [--json] shows the account, whether bb cloud is on and ready,

and today's usage.

• bb ai usage [--json] shows today's spend against the limit and when it

resets (00:00 UTC). Titles, commit messages, and voice input share one budget.

• Sign in with bb account login. Signed out, bb cloud is not ready and

Automatic skips it.

• Which service handles each task is a core setting:

bb settings ai-services set <thread-title|commit-message|voice> bb picks bb cloud, automatic tries bb cloud first, then other compatible registered services by plugin id and service id in lexicographic order, and off turns the task off. bb settings ai-services test thread-title runs a sample.

• Voice input: without a Codex login, the microphone appears once bb cloud is

ready. bb voice transcribe <file> [--type <mime>] transcribes a recording. bb cloud takes WebM, Ogg, MP4/M4A, MP3, WAV, FLAC, and AAC up to 10 MB; it reads the format from the MIME type, then the file extension, and refuses anything else before contacting getbb.app. Each transcription model gets 30 seconds, and a model that times out or fails falls back to the next one.

• When an account's daily limit is used up, bb cloud reports not ready for

that account until the reset and Automatic moves on; a task set to bb falls back to the prompt text for titles and bb: automated commit for commits, and the microphone hides unless another voice service is ready. Signing in to a different account clears the limit message.

While bb cloud is on, bb sends the text of a thread's first prompt (titles), the changed files with a diff excerpt (commit messages), and voice recordings with a vocabulary hint (voice input) to getbb.app, which forwards them to OpenRouter model providers with zero data retention. bb stores daily usage totals and, for 30 days, metadata about each request such as its time, model, token counts, and cost; it never stores prompts, recordings, or replies.