skills.rest
xriu
xriuCOMMUNITY
Explore all skills by this author →
GitHub

bb-cli

Inspect and manage BB threads, machines, environments, and plugins with the bb CLI.

2|2|Updated Dec 23, 2017
Search Tags:#theming#plugin management#thread management#cli automation#environment provisioning#bb cli#machine enrollment
One-click install
npx skills add https://github.com/xriu/dotfiles --skill bb-cli-xriu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bb-cli
Source: https://github.com/xriu/dotfiles/tree/main/home/.agents/skills/bb-cli
Command: npx skills add https://github.com/xriu/dotfiles --skill bb-cli-xriu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Operating the BB platform requires knowing dozens of CLI commands across threads, machines, environments, plugins, themes, and settings; this Skill gives an agent the correct command paths, flags, and workflows so it can inspect and manage BB state without guessing. ## Core Features & Use Cases - Thread and environment management: Spawn, fork, queue, retry, stop, and inspect threads, and manage environments, worktrees, and pull requests through the bb CLI. - Machine and plugin operations: Enroll, create, suspend, and remove machines, and install, configure, update, and debug plugins and marketplaces. - Configuration and theming: Read and change app settings, keyboard shortcuts, sidebar preferences, and custom CSS themes. - Use Case: An agent needs to spawn a background worker thread on a specific machine with a plugin-provisioned environment; it reads the thread-creation reference, resolves provider IDs with bb environment providers --json, and runs bb thread spawn with the correct flags. ## Quick Start Ask the agent to run bb status --json first, then use the bb CLI to list projects, machines, or threads and perform the BB operation you need.

Frequently Asked Questions about bb-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I spawn a BB thread on a specific machine?▼

Use bb thread spawn with --project and --machine <id-or-name>, or combine --new-machine <provider-id> with --environment-provider <id> to create a machine. List options first with bb machine list --json and bb environment providers --json.

How do I retry a failed BB thread?▼

Inspect the failure with bb thread show <id> --json and bb thread log <id>, then run bb thread retry <thread-id> to re-send the failed turn's original message. Add --turn <requestId> to assert which turn you mean or --send-at to schedule the retry.

Can I install BB plugins from npm or git?▼

Yes, bb plugin install accepts npm:<package>[@version], git:<url>[@ref], HTTP(S) repository URLs, local paths, and marketplace entry IDs. Installs prompt for confirmation since plugins are full-trust code; pass --yes to skip in non-interactive shells.

Why is my bb command queued instead of running?▼

A send that cannot run immediately joins the thread's queue with a typed waitingOn reason such as thread-busy, interaction, or provisioning. Inspect it with bb thread queue list and use bb thread queue send to dispatch it now.

How do I create a custom BB app theme?▼

Run bb theme dir to find the theme directory, write a stylesheet to <dir>/<name>/theme.css with :root/.light and .dark blocks overriding CSS variables like --canvas and --primary, then activate it with bb theme set <name>.

Related Skills

Explore More Software Engineering Skills→
osoleveosoleve
7

bbs

Manage issues and dependencies in The Fold's CAS-native BBS.

Community
Basic
chtughachtugha

pr-shepherd

Automate the Pull Request lifecycle with GitHub API and Git commands.

Community
Advanced
kirvinkirvin

configuring-copilot

Guide development of copilot-cli-essentials plugin commands, skills, agents, and hooks.

Community
Intermediate
VincentChong123VincentChong123

qodo-pr-resolver

Resolve Qodo code review issues across multiple git providers.

Community
Advanced