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

# ZeroShot (CLI) Overview

> A single bb binary that captures every coding-agent session and lets your team resume them anywhere.

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

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

```bash theme={null}
bb agent-sessions resume
```

<CardGroup cols={2}>
  <Card title="Install in one line" icon="rocket" href="/pages/ZeroShot/getting-started">
    `curl -fsSL buildbetter.sh | sh`
  </Card>

  <Card title="Source on GitHub" icon="github" href="https://github.com/buildbetter-app/BB-Skills">
    Read the source, file issues, contribute
  </Card>
</CardGroup>

## What you get

<CardGroup cols={3}>
  <Card title="Resumable sessions" icon="clock-rotate-left" href="/pages/ZeroShot/agent-sessions">
    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.
  </Card>

  <Card title="A scriptable CLI" icon="terminal" href="/pages/ZeroShot/cli-reference">
    A small `bb` binary with stable exit codes and `--json` everywhere. Wire it into pre-commit hooks, PR templates, and CI.
  </Card>

  <Card title="Open-source skills" icon="puzzle-piece" href="/pages/ZeroShot/skills">
    Slash commands like `/bb-specify`, `/bb-review`, and `/trust-but-verify` that show up with your team's conventions attached.
  </Card>
</CardGroup>

## The 30-second tour

```bash theme={null}
# 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](/pages/ZeroShot/agent-sessions) for storage paths, the session file schema, and worked workflows.

## What ships in the box

<AccordionGroup>
  <Accordion title="The bb CLI" icon="terminal">
    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](/pages/ZeroShot/cli-reference).
  </Accordion>

  <Accordion title="Cross-machine session sync" icon="cloud-arrow-up">
    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`.
  </Accordion>

  <Accordion title="Spec workflow skills" icon="list-check">
    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`.
  </Accordion>

  <Accordion title="Testing skills" icon="vial">
    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.
  </Accordion>

  <Accordion title="Core skills" icon="screwdriver-wrench">
    Maintenance skills like `/bb-skills-update` to keep installed skills fresh.
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="Free" icon="gift">
    The CLI, all skills, and a BuildBetter account with unlimited session sync. No credit card required.
  </Card>

  <Card title="BuildBetter Signal" icon="wand-magic-sparkles" href="https://buildbetter.ai">
    The paid AI platform that powers customer-signal-driven specs — call/ticket/Slack ingestion, signal extraction, triage, projects. Talk to us.
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Install the CLI" icon="download" href="/pages/ZeroShot/getting-started">
    Run the curl command and verify your install
  </Card>

  <Card title="CLI reference" icon="terminal" href="/pages/ZeroShot/cli-reference">
    Every `bb` command, organized by topic
  </Card>

  <Card title="Sessions deep dive" icon="clock-rotate-left" href="/pages/ZeroShot/agent-sessions">
    What's captured, where it's stored, how resume hydrates state
  </Card>

  <Card title="Skills" icon="puzzle-piece" href="/pages/ZeroShot/skills">
    The slash commands that ship in each pack
  </Card>
</CardGroup>