bb-cli

# BB CLI Use bb for BB state and actions. Inspect context when the target project, host, workspace, or execution selection is not already established. ## Start with context ```sh 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, move the server, 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, ...