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
-
curl -fsSL buildbetter.sh | sh -
Read the source, file issues, contribute
What you get
-
Every coding session — chat, file edits, tool calls — saved and indexed by repo, branch, PR, and commit. Resume any teammate's session on your machine in one command.
-
A small
bbbinary with stable exit codes and--jsoneverywhere. Wire it into pre-commit hooks, PR templates, and CI. -
Slash commands like
/bb-specify,/bb-review, and/trust-but-verifythat show up with your team's conventions attached.
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:
- Watches the agent's session log on disk
- Indexes every new turn by repo · branch · commit · author
- Writes a normalized record to
~/.buildbetter/sessions/ - 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
-
Free
The CLI, all skills, and a BuildBetter account with unlimited session sync. No credit card required.
-
The paid AI platform that powers customer-signal-driven specs — call/ticket/Slack ingestion, signal extraction, triage, projects. Talk to us.
Next steps
-
Run the curl command and verify your install
-
Every
bbcommand, organized by topic -
What's captured, where it's stored, how resume hydrates state
-
The slash commands that ship in each pack