Inspect Git status, branches, changed files, and diffs for an environment through the `bb` CLI. You can also mark files as viewed and read status through another plugin, with results tied to the current file revision and diff target.
Read an environment's git status, changed files, diffs and branches, or mark files Viewed, from the bb CLI; read git status from another plugin.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
The plugin runs git in the environment's workspace on its machine. The Diff tab, the composer's changed-files segment and the Info tab read from it.
bb git status <environment-id> [--merge-base-branch <branch>] [--json]
bb git branches <environment-id> [--query <text>] [--limit <n>] [--json]
bb git diff <environment-id> --target <target> [--json]
bb git files <environment-id> --target <target> [--ignore-whitespace] [--json]
bb git file <environment-id> --target <target> --path <path> --side old|new [--json]
bb git patch <environment-id> --target <target> --path <path>... [--json]
bb git viewed list|mark|unmark|clear <environment-id> --target <target> ...
<target> is uncommitted, branch_committed, all or commit.
Branch targets take --merge-base-branch; commit takes --sha. file
takes --merge-base-ref <sha> for branch targets instead.status includes ahead/behind counts only with --merge-base-branch. Each
file list holds at most 200 entries (tracked changes first); fileCount is
the total. When squash-merge detection hits its limits (1,000 commits,
1 second), mergeBase.squashMergeCheckComplete is false and the counts may
include commits that were already squash-merged.--ignore-whitespace counts and diffs with git -w: whitespace-only files
stay listed with +0 -0 and get an empty patch.files --json reports each file's revision: old and new git modes and blob
ids (<oldMode>:<oldBlob>:<newMode>:<newBlob>). Any content or mode edit,
including whitespace, changes it; staging does not.viewed mark records the current revision unless you pass
--revision; viewed list --path takes up to 500 paths. Mutations print
{ "ok": true } with --json.bb environment status|diff|diff-files|diff-file|diff-patch|branches|diff-viewed
commands still run and print the bb git command that replaced them.showGitChanges (default true) shows the composer's changed-files segment;
turn it off with bb plugin config bb--git set showGitChanges false.
showCommitButton (default false) shows the thread header's Commit action;
turn it on with bb plugin config bb--git set showCommitButton true.
Other plugins read the same data through RPC. status is a keyed read: pass
environment ids and get one row per id, refreshed after the workspace's files
or refs change.
experimental_useRpcKeyedQuery({
pluginId: "bb--git",
contract: gitRpcContract,
method: "status",
keys: [environmentId],
});
bb plugin rpc inspect bb--git prints the input and output schemas.
Branch targets resolve the requested ref first, then fall back to origin/<branch>. If no merge base with HEAD resolves, diff reads report an error instead of an empty diff.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Configure and diagnose Account Pooler in BB, including accounts, authentication, quota-based routing, and failover, which switches to another account. Inspect account and routing state, plus Provider Retry decisions after pooled rate-limit failures.
Configure and troubleshoot agents connected to BB through ACP, an agent connection protocol. Manage agent discovery, registry additions, model choices, custom agent settings, skill locations, and supported conversation compaction, which condenses session context.
Approve a GitHub account to open pull requests in get-bb/bb by updating its allowlist. The workflow verifies the account, checks the change, and creates and merges an approval PR while skipping SlopCop review and CI.
Add comments to specific elements in desktop Browser tabs and include those references in prompts. Edit or delete annotation pins, or update saved comments through the plugin RPC, a command interface for plugins.
Schedule recurring or one-time BB tasks using an agent for work that needs reasoning or a server-side script for fixed checks. Manage schedules, pause and resume tasks, run them manually, and inspect execution history.
Manage the getbb.app account linked to a bb server. Check which account remote access and hosted services use, sign in through a browser or pairing code, and sign out to revoke the server's credential.