gitwtfhub

wtf is bb?

get-bb/bb — explained in plain English

Analysis updated 2026-08-13

1,818TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

bb is an agentic coding IDE that AI agents can control and modify to build and automate itself, accessible via desktop app, web, CLI, or API.

Mindmap

mindmap
  root((bb))
    What it does
      Self building agent IDE
      Multiple driving surfaces
      Steerable threads
    Tech stack
      TypeScript
      Electron
      pnpm
    Use cases
      AI coding agents
      Workflow automation
      Agent handoff
    Audience
      Developers
      AI power users
    Platforms
      macOS
      Linux
      WSL2

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run and steer long-running AI coding agent threads from a desktop app or CLI

REASON 2

Automate parts of your own development workflow by letting bb modify itself

REASON 3

Drive the same agent IDE from desktop, web, CLI, or HTTP API interchangeably

REASON 4

Hand off an in-progress coding task from one AI agent to another

What's in the stack?

TypeScriptViteElectronpnpmSQLite

How it stacks up

get-bb/bbdannymac180/sol-advisorrpamis/comet
Stars1,8181,9261,930
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-03
MaintenanceMaintained
Setup difficultymoderatemoderatemoderate
Complexity3/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an already authenticated AI provider CLI, Windows needs WSL2.

Wtf does this do

bb is an agentic coding IDE that is built to work on itself. Instead of being a normal app you download once and never touch again, bb is designed so that AI agents running inside it can control, customize, and automate the tool, which the project describes as laying the groundwork for a personal software factory. You can work with bb through several different surfaces: a desktop app, a web app, a command line interface, and an HTTP API, and all of them are treated as equally capable ways to drive the tool. Work happens inside threads that you can watch live as they run, step in and steer at any moment, or hand off to a different agent to continue. The project notes it is in active development, with the core architecture considered stable while the surfaces and workflows are still changing. The easiest way to start is downloading the desktop app, which currently supports macOS on both Apple Silicon and Intel chips. Linux users are told to run bb with npx instead, and Windows users need to install it inside WSL2, since native Windows PowerShell and CMD are not supported. There is also a Nightly build available for early adopters who want to test the newest automated builds alongside the stable version. bb relies on whichever AI provider command line tool you already have set up and authenticated on your machine rather than bundling its own model access. When you run the production app, it sends anonymous usage telemetry, such as app starts and message counts tied to a random per-install id, though no personal content or identifying details are included, and this can be turned off with an environment variable. For developers who want to build bb itself rather than just use it, the project includes a full development workflow built on pnpm, with separate commands for running the app, the server, and the desktop shell, plus tools for resetting local state and troubleshooting native dependency issues.

Yoink these prompts

Prompt 1
Walk me through installing bb with npx and opening it in my browser
Prompt 2
Explain how bb's threads let me steer or hand off an AI agent's work in progress
Prompt 3
Help me set up bb's development environment using pnpm dev
Prompt 4
What AI provider CLI do I need authenticated before I can use bb?
Prompt 5
How do I fix the 'Could not locate the bindings file' error when running bb?

Frequently asked questions

wtf is bb?

bb is an agentic coding IDE that AI agents can control and modify to build and automate itself, accessible via desktop app, web, CLI, or API.

What language is bb written in?

Mainly TypeScript. The stack also includes TypeScript, Vite, Electron.

How hard is bb to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is bb for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.