Desktop app for running multiple coding agents side by side, each in its own git worktree, with a mobile companion for monitoring.
get-bb/bb
An agentic IDE that can control, customize and automate itself, driven from a desktop app, web app, CLI or HTTP API.
Open-source alternative to:Cursor
- Stars
- 4,971
- Forks
- 765
- Open issues
- 752
- Last commit
- 11 hours ago
What is it?
bb is an agentic IDE aimed at developers who want coding agents to work inside a managed environment. Its goal is to let the IDE control, customize and automate itself, which the project describes as a foundation for building your own software factory.
Work happens in threads that you can follow live, steer at any point, or hand off to another agent. The desktop app, web app, CLI and HTTP API are all first-class ways to drive it. The desktop app currently targets macOS on Apple Silicon, while Linux and Windows builds are in alpha. Intel Mac users and other platforms can run it through npx, and it uses the provider CLI you already have authenticated.
The project is in active development, so the core architecture is stable but workflows and surfaces are still changing. It is written in TypeScript and distributed as an npm package named bb-app.
Key features
- 01Desktop app, web app, CLI and HTTP API all control the same IDE.
- 02Threads can be followed live, steered mid-task, or handed off to another agent.
- 03Runs with the provider CLI you already have authenticated.
- 04Can be launched with npx bb-app@latest on any platform with Node.js.
- 05Includes a development loop with separate data directories per checkout and worktree.
Use cases
- Running several coding agents in parallel threads and reviewing their output.
- Automating IDE tasks through the CLI or HTTP API.
- Experimenting with a self-modifying IDE as a base for an internal software factory.
Quick start
- 1
Download the desktop app for macOS (Apple Silicon) from the releases page
- 2
Or run bb anywhere with npx
npx bb-app@latest - 3
Open the local web app in your browser
Things to know
- The Linux and Windows desktop builds are alpha and may have problems.
- Native Windows also requires Git for Windows.
- bb is in active development, and its workflows and surfaces are still evolving.
- npm 12 and later block the install scripts bb needs, so extra flags may be required.
In collections
Topics
FAQ
- What is bb?
- An agentic IDE that can control, customize and automate itself, driven from a desktop app, web app, CLI or HTTP API. bb is an agentic IDE aimed at developers who want coding agents to work inside a managed environment. Its goal is to let the IDE control, customize and automate itself, which the project describes as a foundation for building your own software factory.
- Is bb free to use? What license does it have?
- bb is open source under the MIT license. Check the license terms before using it in commercial products.
- Is bb still maintained?
- Actively maintained. The last commit to bb was on Nov 7, 2026.
- What can I use bb for?
- Running several coding agents in parallel threads and reviewing their output. Automating IDE tasks through the CLI or HTTP API. Experimenting with a self-modifying IDE as a base for an internal software factory.
- How do I install bb?
- Download the desktop app for macOS (Apple Silicon) from the releases page Or run bb anywhere with npx: npx bb-app@latest Open the local web app in your browser
- Where can I get bb?
- The source code and installation instructions are on GitHub: https://github.com/get-bb/bb
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Desktop, mobile, web and CLI app for running and orchestrating multiple coding agents such as Claude Code, Codex and OpenCode in parallel worktrees.
Desktop IDE for running Claude Code, Codex, OpenCode and other CLI coding agents in parallel, each in its own Git worktree.
A lightweight cross-platform IDE for AI coding that runs multiple Claude Code and Codex agent sessions across projects in one window.
A curated, validated registry of installable skills that extend AI coding agents such as Claude Code, Cursor and Copilot, with a CLI to install them.
An open-source coding agent that reads your project, edits files and runs tests from your terminal, desktop, browser or editor.