Skip to content
cccskills
FreePublished on GitHub

bb-cli

Inspect and manage BB threads, environments, projects, and plugins through its command line interface. The skill guides agents to identify the correct targets, apply changes, and verify the resulting state.

OriginalShow the original description

Use this when controlling bb. The bb CLI inspects and manages threads, environments, projects, machines, providers, skills, plugins, settings, terminals, and other BB services.

See how to install

Good for

  • Check BB projects and environment status
  • Manage skills and plugins
  • Create or operate threads
  • Investigate failed threads

Files included (10)

  • SKILL.md3.2 KB
  • references/app-settings.md4.3 KB
  • references/command-index.md4.8 KB
  • references/configuration.md3.7 KB
  • references/failure-recovery.md2.4 KB
  • references/plugins.md13.2 KB
  • references/theme-commands.md3.4 KB
  • references/theming.md11.7 KB
  • references/thread-creation.md10.5 KB
  • references/thread-operation.md10.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

BB CLI

Never inspect or message other threads unless the user explicitly requests that action.

Use bb for BB state and actions. Inspect the current context before you choose IDs, machines, workspaces, providers, or models.

Start with context

bb status --json

Use JSON when command output controls later work. Use human output for quick inspection.

Run bb --version for the CLI version. Use bb --help or bb help [command] for help. Run bb guide for the system overview. Run bb guide <chapter> for one area. Use bb <group> --help for current flags and defaults.

A standalone CLI targets http://127.0.0.1:38886. Use BB_SERVER_URL and BB_HOST_DAEMON_PORT only for an intentional non-default target.

Read only the relevant reference

  • Read references/command-index.md to find the exact core command path. Use live help for current flags and defaults.
  • Read references/configuration.md for settings, agent instructions, skills, remote clients, and environment setup scripts.
  • Read references/thread-creation.md before you spawn or fork threads, create projects, select machines, or create environments.
  • Read references/thread-operation.md for messages, queues, interactions, panes, terminals, inspection, and long-running commands.
  • Read references/failure-recovery.md when a thread fails, stops, or needs plan or goal recovery.
  • Read references/theme-commands.md for palette and favicon commands. Read references/theming.md before you create or edit theme CSS.
  • Read references/plugins.md for plugin discovery, install, build, update, configuration, runtime, and contributed commands.
  • Read references/app-settings.md for complete app setting keys and effects.

Command habits

  • Resolve names and IDs with a list or show command before mutation.
  • Pass an explicit project when a command can act across projects.
  • Pass an environment or machine selector when the default host is uncertain.
  • Query provider models on the machine that will run the thread.
  • Prefer non-interactive commands and machine-readable output for automation.
  • Pass --yes for a confirmed destructive command in a non-interactive shell.
  • Treat plugin commands as normal top-level commands after installation.
  • Inspect real status, logs, API results, or diffs instead of assumptions.
  • Keep file paths on the machine that owns the selected workspace.
  • BB rejects symlinks as project/environment roots (Root path ... must not be a symlink). Use real directories. Before a rename or rollback, check every affected environment and thread; changing only project sources is not enough.

Common checks

bb project list --json
bb machine list --json
bb provider list --environment "$BB_ENVIRONMENT_ID" --json
bb thread show "$BB_THREAD_ID" --json
bb environment status "$BB_ENVIRONMENT_ID" --json
bb plugin list --json
bb skill list --environment "$BB_ENVIRONMENT_ID" --json

Completion

Confirm the command result and any affected thread, environment, plugin, or remote service. Report the stable ID or URL that the user needs next.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

4x4

FreeSummary

Work through sixteen open questions in four rounds to clarify major product decisions, risky changes, or large refactors. The agent adapts later questions to earlier answers, then turns your decisions into a step-by-step implementation plan.

  • Clarifying decisions before a major product change
  • Planning a large refactor
  • Deciding rollout order for a risky change
davidondrej/skills4.2KUpdated Oct 19, 2026

adr-verbatim

FreeSummary

Document approved decisions as concise ADRs, or architecture decision records. It preserves the user's meaning and conditions, removes conversational filler, follows the project's numbering, and presents the saved record for review.

  • Record a decision approved in conversation
  • Preserve the conditions and scope of a decision
  • Add a numbered ADR to existing records
davidondrej/skills4.2KUpdated Oct 19, 2026

anti-sleep

FreeSummary

Keep a Mac awake for a chosen duration or while a specified process runs. The skill uses built-in macOS tools to manage one session, verify that sleep prevention is active, and control whether the display stays on.

  • Keep a Mac awake during a lengthy task
  • Prevent sleep while a specified process runs
  • Allow the display to dim while keeping the Mac awake
davidondrej/skills4.2KUpdated Oct 19, 2026

ask-then-build

FreeSummary

Turn a feature or refactoring idea into a concise implementation prompt for another agent. It asks focused questions one at a time, records decisions, and includes development steps, validation, and working rules.

  • Clarify requirements for a new feature
  • Decide edge cases and failure behavior
  • Define the scope of a refactor
davidondrej/skills4.2KUpdated Oct 19, 2026

bb-plugins

FreeSummary

Create, install, and debug TypeScript plugins that extend bb with custom pages, sidebar panels, CLI commands, agent tools, themes, and other features. The skill also guides development reloads, log checks, and verification of installed plugins.

  • Add a custom page or sidebar panel to bb
  • Create a bb CLI command or agent tool
  • Investigate plugin errors through logs
davidondrej/skills4.2KUpdated Oct 19, 2026

before-building

FreeSummary

Identify one to three important decisions before starting a build. Based on the user's idea, this skill presents concise options and an initial recommendation for each, then waits for answers before work proceeds.

  • Clarifying important decisions before implementation
  • Deciding whether a solution needs to be reusable
  • Choosing between a short script and a separate module
davidondrej/skills4.2KUpdated Oct 19, 2026

See all skills by davidondrej

Report a problem with this skill