Getting Started
Getting Started with ZeroShot
Install in one line, sign in once, then your AI coding agent picks up the ZeroShot skills automatically.
1. Install the CLI
Run this in your terminal:
curl -fsSL buildbetter.sh | sh
The installer will:
- Download the
bbbinary for your OS and architecture - Place it in
~/.buildbetter/bin/bband add that directory to yourPATH - Detect which coding agents you have installed (Claude Code, Codex, Cursor, etc.) and offer to install matching skill packs
Tip: Prefer to read the script first? Open buildbetter.sh in your browser to inspect it, then download and pipe to
shonce you're satisfied.
Prerequisites
| Requirement | Notes |
|---|---|
| OS | macOS 12+ or Linux (x86_64 / arm64) |
| Shell | bash, zsh, or fish |
| Git | Required — sessions are indexed by repo, branch, and commit |
| At least one coding agent | Claude Code, Codex, Cursor, Copilot CLI, Gemini CLI, Windsurf, or Amazon Q |
2. Verify the install
bb --version
bb doctor
bb doctor reports which agents it detected, where their skill directories live, and whether your PATH and shell rc files are wired up correctly.
3. Sign in (optional but recommended)
bb login
A browser window opens for you to authenticate with your free BuildBetter account. After signing in:
- Your agent sessions sync to the cloud and become resumable on any machine
- Teammates can pull each other's sessions for the same branch
- Skills update automatically when your team improves them
You can skip this step and use the CLI fully offline — sessions just stay local.
4. Install the skills
The installer prompts you to install the default packs, or you can install them manually:
bb skills install spec-workflow
bb skills install testing
bb skills install core
To see everything installed:
bb skills list
To update later:
bb skills update
5. Use the skills in your agent
Open your coding agent and type / — the ZeroShot skills appear in the slash command list.
-
/bb-specify
Draft a feature spec from a description, with customer signals attached
-
/bb-plan
Generate a phased implementation plan from the spec
-
/bb-review
Review code against your team's encoded conventions
-
/trust-but-verify
Walk the UI like a real user before merging
See the skills reference for the full list.
Updating
bb update
This refreshes the bb binary and updates every installed skill pack.
Uninstalling
bb uninstall
This removes the bb binary, every installed skill, and the ~/.buildbetter/ directory. Your agent sessions in the BuildBetter cloud are not deleted — sign in to buildbetter.ai and delete them there if you want them gone.
Troubleshooting
`bb: command not found` after install
The installer added ~/.buildbetter/bin to your shell's rc file, but the current shell doesn't have it loaded. Open a new terminal window, or run source ~/.zshrc (or ~/.bashrc).
Skills don't show up in my coding agent
Run bb doctor to confirm the skills directory matches what your agent expects. Restart the agent after installing or updating skills — most agents only scan the skills directory at startup.
`curl | sh` is blocked by my org
Download the binary directly from the latest release and place it on your PATH manually. Then run bb skills install spec-workflow testing core to fetch the skill packs.
I'm behind a corporate proxy
bb respects standard HTTP_PROXY / HTTPS_PROXY / NO_PROXY environment variables. Set them in your shell before running bb login or bb skills update.
Next steps
-
See what each skill does and when to reach for it
-
Pick up where a teammate left off