bb

Product Introduction

1. Definition: bb is an open-source, local-first, agentic orchestrator and integrated development environment (IDE) designed for loop-driven development. It functions as a graphical user interface (GUI) that manages and coordinates multiple AI coding agents from different providers.
2. Core Value Proposition: bb exists to eliminate the rigidity of traditional development environments by providing a fully extensible, self-customizing workspace. Its core value is enabling developers to build their ideal AI-powered software factory, where the tool itself can be modified on-the-fly through natural language prompts, and where multiple AI agents can collaborate on tasks.

Main Features

1. Self-Customizing GUI & Plugin System: Almost any component within the bb interface can be modified or extended through a single prompt. For example, requesting a task tracker automatically generates the necessary plugin code, adds a sidebar panel, creates a CLI command (bb tasks), and teaches all connected AI agents how to use the new feature. This is powered by its own internal plugin architecture, which is the same system used to build its native features like GitHub integration and agent memory.
2. Multi-Agent Orchestration: bb supports and manages AI coding agents from a wide range of providers including Anthropic's Claude Code, OpenAI's Codex, Cursor, Pi, OpenCode, Grok, omp, and Hermes. Users can assign tasks to specific agents or have one agent spawn and manage others, with each agent operating in its own isolated thread. Crucially, bb uses your existing provider subscriptions; it is not a billing intermediary.
3. Universal Automation Trigger & CLI: Work in bb can be initiated from any external program. Its command-line interface (CLI), which is the same one used by its AI agents, is exposed for integration with shell scripts, cron jobs, or custom bots (e.g., Hermes Agent in Telegram/Signal/Slack). These external triggers can spawn development threads that appear in the bb sidebar, enabling asynchronous, event-driven workflows.
4. Local-First & Open-Source Architecture: bb runs primarily on the user's local machine, ensuring data privacy and immediate access. Its entire codebase, from the core orchestrator to the GUI and default plugins, is licensed under the MIT license, allowing organizations to fork, customize, and deploy their own versions internally.

Problems Solved

1. Pain Point: Vendor lock-in and limited extensibility in AI-powered development tools. Many AI coding assistants and workspaces are closed systems with fixed feature sets, forcing users to wait for official updates to address their specific workflow needs.
2. Target Audience: Senior Software Engineers, Tech Leads, and Developer Productivity teams who actively integrate multiple AI coding assistants into complex workflows. It also targets open-source contributors and organizations wanting to build proprietary, AI-augmented development tooling.
3. Use Cases: 1. Rapid Workflow Customization: A team needs a custom dashboard to track code review metrics; a developer prompts bb to create it, and it's instantly available. 2. Cross-Agent Task Management: A developer uses Claude Code to architect a feature, then spawns a Codex agent via bb to handle the TypeScript conversion, managing both from one interface. 3. CI/CD Integration: A failing CI pipeline automatically triggers a bb thread via a webhook to diagnose and fix the issue before a developer is even aware.

Unique Advantages

1. Differentiation: Unlike monolithic AI IDEs or single-provider assistants, bb is a provider-agnostic orchestrator. Unlike script-heavy DIY agent setups, it offers a polished, extensible GUI. Its key differentiator is its self-modifying capability—treating the IDE itself as a malleable application built on its own public API.
2. Key Innovation: The "prompt-to-plugin" system. The ability to semantically describe a new feature (e.g., "Add a task management system") and have the environment not only build the functional plugin but also automatically integrate it into the UI, CLI, and agent skill sets is a foundational shift. It turns the IDE from a static tool into a dynamic, user-programmable substrate.

Frequently Asked Questions (FAQ)

1. How does bb handle billing for AI models like Claude and Codex? bb does not charge for AI model usage. It operates on a bring-your-own-key (BYOK) model, connecting directly to the APIs of supported providers. Users are billed directly by Anthropic, OpenAI, or other providers based on their own existing subscription plans and usage.
2. Is bb truly "local-first"? What data leaves my machine? The bb application runs locally on your machine. The primary data that leaves your workstation are the API calls sent to the AI providers you choose to use (e.g., OpenAI, Anthropic). Your code, project context, and custom plugin configurations remain on your local system unless you integrate with remote services like GitHub voluntarily.
3. Can I use bb for team collaboration or in an enterprise setting? Yes, due to its MIT open-source license, teams can fork the bb repository, customize it for their internal development standards and security requirements, and deploy the customized version across their organization. It supports collaborative workflows through its task delegation and multi-threaded agent features.
4. What programming languages and tech stacks does bb support? bb itself is a development environment orchestrator and is not limited to a specific language. The AI agents it coordinates (like Claude Code, Codex) have their own language proficiencies. bb's value is in orchestrating the agents that work on your codebase, regardless of the stack (JavaScript/TypeScript, Python, Go, etc.).
5. How does the "agent memory" feature work? Agent memory in bb is implemented as a plugin, meaning it's built using the same extensible system available to users. It likely provides agents with contextual recall across a thread or session, allowing them to reference prior decisions and code changes. As an open-source plugin, its implementation can be examined and modified.