> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Install the ZeroShot CLI in one line and connect your coding agent.

# 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:

```bash theme={null}
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](https://buildbetter.sh) in your browser to inspect it, then download and pipe to `sh` once you're satisfied.
</Tip>

### 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

```bash theme={null}
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)

```bash theme={null}
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:

```bash theme={null}
bb skills install spec-workflow
bb skills install testing
bb skills install core
```

To see everything installed:

```bash theme={null}
bb skills list
```

To update later:

```bash theme={null}
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.

<CardGroup cols={2}>
  <Card title="/bb-specify" icon="file-pen">
    Draft a feature spec from a description, with customer signals attached
  </Card>

  <Card title="/bb-plan" icon="diagram-project">
    Generate a phased implementation plan from the spec
  </Card>

  <Card title="/bb-review" icon="magnifying-glass">
    Review code against your team's encoded conventions
  </Card>

  <Card title="/trust-but-verify" icon="circle-check">
    Walk the UI like a real user before merging
  </Card>
</CardGroup>

See the [skills reference](/pages/ZeroShot/skills) for the full list.

## Updating

```bash theme={null}
bb update
```

This refreshes the `bb` binary and updates every installed skill pack.

## Uninstalling

```bash theme={null}
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](https://buildbetter.ai) and delete them there if you want them gone.

## Troubleshooting

<AccordionGroup>
  <Accordion title="`bb: command not found` after install" icon="terminal">
    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`).
  </Accordion>

  <Accordion title="Skills don't show up in my coding agent" icon="puzzle-piece">
    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.
  </Accordion>

  <Accordion title="`curl | sh` is blocked by my org" icon="shield">
    Download the binary directly from the [latest release](https://github.com/buildbetter-app/BB-Skills/releases) and place it on your `PATH` manually. Then run `bb skills install spec-workflow testing core` to fetch the skill packs.
  </Accordion>

  <Accordion title="I'm behind a corporate proxy" icon="network-wired">
    `bb` respects standard `HTTP_PROXY` / `HTTPS_PROXY` / `NO_PROXY` environment variables. Set them in your shell before running `bb login` or `bb skills update`.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Browse the skills" icon="book" href="/pages/ZeroShot/skills">
    See what each skill does and when to reach for it
  </Card>

  <Card title="Resume an agent session" icon="clock-rotate-left" href="/pages/ZeroShot/agent-sessions">
    Pick up where a teammate left off
  </Card>
</CardGroup>