Skip to main content

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.

This page tracks the BuildBetter CLI (bb) and the open-source BB-Skills packs. For the main BuildBetter web app, see the BuildBetter Changelog. For the desktop and mobile Recorder, see the Recorder Changelog.Source: github.com/buildbetter-app/BB-Skills (MIT-licensed).

​
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.
​
2026-05-05
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.
​
2026-04-28
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.

​
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.
​
2026-04-02
v1.1.1

​
✨ Improvements

  • Staging environment support in the configure command — point bb-skills at staging when needed.
​
2026-04-02
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.
​
2026-04-02
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.
​
2026-04-02
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 (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 (MIT).
  • Extended with BuildBetter customer evidence integration.
​
2026-02-28
v0.0.1
Initial scaffolding release.

​
🚀 New

  • BB-Skills launch — BuildBetter-enriched spec workflow built on the spec-kit foundation.