Download
GBB on your desk and in your terminal
The gbb CLI brings repositories, issues, pull requests, Actions, and checks to any shell. The free desktop editor, with agent sessions, is coming soon. Both talk to the same platform you review and release on.
Command line
The gbb CLI
One native Rust binary, version 0.8.0. Authenticate once — into the OS credential store when one is available — wire up Git's credential helper for this host only, then work with repositories, issues, pull requests, Actions, and checks without leaving the shell.
Device login stored in Keychain, Credential Manager, or Secret Service; on hosts without one, saving credentials requires an explicit --plaintext-store opt-in
GBB_TOKEN for CI — validated, never persisted
--json, --jsonl, shell completions, stable exit codes
Every archive ships a SHA-256 sum, a Sigstore bundle, and an SPDX SBOM
# private preview: gh must be signed in to a GitHub account with access
VERSION=0.8.0
ASSET="gbb-v$VERSION-x86_64-unknown-linux-gnu.tar.gz"
gh auth status
gh release download cli-main-latest --repo AstraRMM/git-platform \
--pattern "$ASSET" --pattern "$ASSET.sha256" --pattern "$ASSET.sigstore.json"
# verify before you trust it
sha256sum --check "$ASSET.sha256"
cosign verify-blob --bundle "$ASSET.sigstore.json" \
--certificate-identity "https://github.com/AstraRMM/git-platform/.github/workflows/cli-release.yml@refs/heads/main" \
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" "$ASSET"
# install
tar -xzf "$ASSET" && install -Dm755 gbb "$HOME/.local/bin/gbb"
gbb version
gbb 0.8.0
| Platform | Target | Ships with |
|---|---|---|
| macOS · Apple Silicon | aarch64-apple-darwin · .tar.gz | .sha256 · .sigstore.json · SBOM |
| macOS · Intel | x86_64-apple-darwin · .tar.gz | .sha256 · .sigstore.json · SBOM |
| Linux · x64 | x86_64-unknown-linux-gnu · .tar.gz | .sha256 · .sigstore.json · SBOM |
| Windows · x64 | x86_64-pc-windows-msvc · .zip | .sha256 · .sigstore.json · SBOM |
The preview repository is private: downloading needs a GitHub account with access, and anonymous release URLs return 404 by design. Verify provenance with gh attestation verify <archive> --repo AstraRMM/git-platform; a release manifest binds every published digest to its source commit and workflow run. If a checksum, signature, or attestation check fails, do not install the artifact.
Commands
From the generated command reference · gbb 0.8.0
Desktop app
GBB Desktop
A performance-first desktop IDE: durable multiplayer sessions, agents that write from isolated worktrees at the access level you grant, and native Git and search. Free, and coming soon.
published here once release verification passes
Release channel · stable
How a desktop release reaches this page
Tagged version
A desktop release is cut from a tagged version, never from a moving branch.
Signed builds
macOS and Windows builds are signed; Linux ships as a .deb package.
Release verification
The release is checked before anything is published.
Published here
Downloads appear on this page, and installed macOS and Windows builds pick the release up from the signed update manifest.
What each release ships
Download buttons appear here the moment a release clears verification. Until then, the gbb CLI below is available to preview participants today.
The gbb CLI comes along
Every desktop build bundles the command-line client, so installing the app also puts the CLI on your machine.
Updates itself
On macOS and Windows, installed builds check a signed update manifest on the stable channel and apply new releases in place. On Linux, install the new .deb from this page when a release ships.
Then push your first repository
Create an account and push a repository with the gbb CLI or plain git. Hosted Actions workflows are planned for launch.