bb-cli
Use this when controlling bb. The bb CLI inspects and manages threads, environments, projects, machines, providers, skills, plugins, settings, terminals, and other BB services.
Install / Use
npx skills add davidondrej/skills --skill bb-cliInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Tags
Our assessment of bb-cli
bb-cli scores 87/100 on our quality scale, 356th of 642 Marketing skills we index.
Its SKILL.md is 3.2 KB long, split into 6 sections with 2 code examples: a solid amount of guidance for an agent.
With 4,079 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so bb-cli is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
bb-cli compared with similar skills
All 4 of these similar skills score higher than bb-cli; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bb-cli (this skill)by davidondrej | 87 | 4.1k | 53d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install bb-cli?
- Run
npx skills add davidondrej/skills --skill bb-cli. The install tabs above show the steps for each supported agent. - Which AI agents does bb-cli work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is bb-cli safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is bb-cli still maintained?
- The repository was last updated about 2 months ago, so bb-cli is actively maintained.
Skill content
View source on GitHubname: bb-cli 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.
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
--yesfor 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.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
