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

# CLI Changelog

> Updates to BuildBetter SH — the `bb` CLI and the open-source BB-Skills packs.

<Info>
  This page tracks the **BuildBetter CLI** (`bb`) and the open-source **BB-Skills** packs. For the main BuildBetter web app, see the [BuildBetter Changelog](/changelog). For the desktop and mobile Recorder, see the [Recorder Changelog](/recorder-changelog).

  Source: [github.com/buildbetter-app/BB-Skills](https://github.com/buildbetter-app/BB-Skills) (MIT-licensed).
</Info>

## `bb` CLI

The `bb` binary captures agent sessions and lets your team resume them anywhere. These features ship with the BuildBetter platform and update alongside the web app.

<Update label="2026-05-05" description="v4.19 platform release">
  ### 🚀 New Features

  * **BB CLI Support Tools** — `bb` now includes diagnostics, support bundle creation, and feedback submission to make troubleshooting easier.
  * **CLI Session Resume Filters** — Filter resumed agent sessions by provider, session, branch, commit, repository, or pull request.
  * **CLI Hook Management** — Install, repair, check, and remove Codex and Claude hooks from one place.

  ### ✨ Improvements

  * **CLI Updates and Install Experience** — Auto-update enabled for direct installs; clearer upgrade instructions for package-manager installs.
  * **Cleaner CLI Hook Output** — Hook output is quieter and easier to read, while still logging useful details when something goes wrong.
  * **Safer CLI Support Diagnostics** — Auth and support details easier to inspect, with permission checks and redacted diagnostics for privacy.

  ### 🐛 Bug Fixes

  * **CLI Release Publishing Fix** — Release publishing works correctly even when the workflow runs without a checked-out repository.
  * **Large CLI Session Uploads** — Large agent session uploads succeed more reliably, with full tool output preserved.
</Update>

<Update label="2026-04-28" description="v4.18 platform release">
  ### 🚀 New Features

  * **BuildBetter CLI Session Resume** — Previously uploaded Codex and Claude sessions can now be reopened on the current branch with `bb agent-sessions resume`.
</Update>

## BB-Skills (open-source skill packs)

The Python `bb-skills` package installs and updates the skill packs that your coding agent uses. Versioned independently on PyPI and GitHub.

<Update label="2026-04-02" description="v1.1.1">
  ### ✨ Improvements

  * **Staging environment support** in the `configure` command — point `bb-skills` at staging when needed.
</Update>

<Update label="2026-04-02" description="v1.1.0">
  ### 🚀 New Features

  * **`bb-` prefix on spec-workflow skills** — spec-workflow skill names now carry a `bb-` prefix so they don't collide with other skill catalogs.
  * **`configure` command** — set up workspace defaults and environment from one CLI command.
</Update>

<Update label="2026-04-02" description="v1.0.1">
  ### 🐛 Bug Fixes

  * **PyPI installation path fix** — `bb-skills` now finds its skills directory when installed via `pip install` / `uvx` instead of from source.
</Update>

<Update label="2026-04-02" description="v1.0.0">
  First public release of BB-Skills — AI coding skills for any coding agent.

  ### 🚀 New

  * **Skills-first architecture** with pack-based installation.
  * **Three skill packs:**
    * `core` — base skills including `bb-skills-update`
    * `spec-workflow` — 9 skills derived from [github/spec-kit](https://github.com/github/spec-kit) (MIT), extended with BuildBetter customer evidence integration
    * `testing` — 3 browser testing skills (`app-navigator`, `trust-but-verify`, `generate-tests`)
  * **Multi-platform support** via 7 adapters: Claude Code, Codex, Cursor, Copilot, Gemini, Windsurf, Amazon Q.
  * **`bb-skills` CLI** with `install`, `update`, `list`, `uninstall`, `platforms` commands.
  * **User-initiated update checking** via GitHub releases.

  ### Acknowledgments

  * Spec-workflow skills derived from [github/spec-kit](https://github.com/github/spec-kit) (MIT).
  * Extended with BuildBetter customer evidence integration.
</Update>

<Update label="2026-02-28" description="v0.0.1">
  Initial scaffolding release.

  ### 🚀 New

  * **BB-Skills launch** — BuildBetter-enriched spec workflow built on the spec-kit foundation.
</Update>