BuildBetter Docs

ZeroShot (CLI) Overview

Note: Free and open source. The CLI and skills are MIT-licensed and live at github.com/buildbetter-app/BB-Skills. You can use them with or without a paid BuildBetter account.

ZeroShot

ZeroShot (the bb CLI) sits next to your AI coding agent and gives it the context behind every PR — the chats, decisions, customer signals, and team conventions that produced the code.

You install it once. It runs passively in the background, capturing every session you have with Claude Code, Codex, Cursor, Copilot CLI, Gemini CLI, Windsurf, or Amazon Q. Then anyone on your team can pick those sessions back up — on their machine, six months later, on a long-merged branch — with one command:

bb agent-sessions resume

What you get

The 30-second tour

# 1. Install
curl -fsSL buildbetter.sh | sh

# 2. (Optional) Sign in to sync sessions across machines and teammates
bb login

# 3. Code with your agent like normal — bb captures every session
#    in the background. No daemon, no flags, no daily startup.

# 4. Pick up where you (or anyone on your team) left off
bb agent-sessions resume

That's the whole loop. Everything else — skills, PR linking, scripting — is built on top.

How sessions work

Whenever you use a supported coding agent inside a git checkout, bb:

  1. Watches the agent's session log on disk
  2. Indexes every new turn by repo · branch · commit · author
  3. Writes a normalized record to ~/.buildbetter/sessions/
  4. Syncs to your free BuildBetter workspace if you're signed in

When you (or a teammate) run bb agent-sessions resume, the chosen session is hydrated back into your active agent — prior conversation, file edits as a virtual diff, and any open questions the previous session left behind. You're not reading a transcript; you're picking the work back up.

See Agent Sessions for storage paths, the session file schema, and worked workflows.

What ships in the box

The bb CLI

A single bb binary that captures sessions, syncs them across machines, manages skills, and bridges your coding agent to BuildBetter. macOS and Linux, x86_64 and arm64. See the CLI reference.

Cross-machine session sync

Sessions are indexed by repo, branch, PR, and commit, then synced through your free BuildBetter account so any teammate with access to the repo can resume them. Opt-out per repo with bb config set sync.enabled false.

Spec workflow skills

Nine skills that drive a spec-first workflow: /bb-specify, /bb-clarify, /bb-plan, /bb-tasks, /bb-checklist, /bb-analyze, /bb-review, /bb-implement, /bb-constitution.

Testing skills

Three browser-driven verification skills: /app-navigator, /trust-but-verify, /generate-tests. They walk the UI like a real user and confirm a feature actually works before you merge.

Core skills

Maintenance skills like /bb-skills-update to keep installed skills fresh.

Supported coding agents

Agent Status
Claude Code Supported
Codex CLI Supported
Cursor Supported
GitHub Copilot CLI Supported
Gemini CLI Supported
Windsurf Supported
Amazon Q Developer Supported

Pricing

Next steps