BuildBetter Docs

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:

  1. Download the bb binary for your OS and architecture
  2. Place it in ~/.buildbetter/bin/bb and add that directory to your PATH
  3. 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 sh once 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.

bb login

A browser window opens for you to authenticate with your free BuildBetter account. After signing in:

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.

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