Skip to content
alyn
davidondrej

Bb CLI skill

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

$npx skills add davidondrej/skills --skill bb-cli
View this skill on GitHubdavidondrej/skills/skills/bb-cli/SKILL.md
Pack stars
4,291
Pack installs
10k
Alyn Score
64/99
Updated
2 h ago
License
MIT
– views – installs via Alyn

davidondrej

Bb CLI

Coding

Install Bb CLI

Pick your agent. Every command is ready to paste.

$npx skills add davidondrej/skills --skill bb-cli

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads bb-cli when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the bb-cli skill”. In Codex, type $bb-cli.

The skill itself

SKILL.md

FolderGitHub

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 for one area. Use bb --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.

Tips for Bb CLI

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
  • • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Bb CLI

What does the Bb CLI skill do?

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

How do I install Bb CLI?

Run "npx skills add davidondrej/skills --skill bb-cli" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Bb CLI work in Cursor and Codex?

Yes. Bb CLI uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Bb CLI free?

Bb CLI is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.

Who made Bb CLI?

Bb CLI is published by davidondrej in the davidondrej/skills repository, together with 29 other skills.

Similar skills. From other creators.