bc

bc

AI agents are powerful alone — chaotic when they work together. bc fixes that.

Coordinate teams of Claude, Gemini, Cursor, and other AI agents with isolated worktrees, shared channels, and cost controls. One binary. No login. MIT licensed.

Install

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/rpuneet/bc/main/scripts/install.sh | bash

# Homebrew
brew install rpuneet/bc/bc

# Go
go install github.com/rpuneet/bc/cmd/bc@latest

# From source
git clone https://github.com/rpuneet/bc && cd bc && make install-local-bc

Prerequisites: Go 1.25+, tmux, git. For TUI: Bun.

Quick Start

bc init                    # Initialize workspace
bc up                      # Start server + web UI on localhost:9374
bc agent create eng-01 \
  --role engineer \
  --tool claude            # Spawn an agent
bc status                  # See what's running
bc agent peek eng-01       # Watch agent output
bc cost show               # Check spending

Open http://localhost:9374 for the web dashboard.

What bc Does

Without bc: One agent at a time. Context lost between sessions. Merge conflicts from parallel edits. No visibility. Surprise bills.

With bc: Multiple agents in parallel. Each gets its own git worktree — zero conflicts. Persistent channels for structured communication. Per-agent budgets with hard stops. Everything observable in real time.

How It Works

1. Isolated by design — Each agent runs in its own tmux session (or Docker container) with a dedicated git worktree. They can't step on each other's work.

2. Structured communication — Agents talk through persistent channels with mentions, reviews, and handoffs. Not through you.

3. Full visibility — Costs, activity, resource usage — all in real time through CLI, TUI, or web dashboard.

Supported Agents

Commands

Core

Agents

Channels

Cost & Scheduling

Configuration

Full reference: bc --help or bc <command> --help

Architecture

┌─────────────────────────────────────────────────┐
│                    bc binary                     │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐  │
│  │   CLI    │  │   TUI    │  │  HTTP Server  │  │
│  │ (Cobra)  │  │ (Ink/    │  │  + Web UI     │  │
│  │          │  │  React)  │  │  + MCP + SSE  │  │
│  └────┬─────┘  └────┬─────┘  └───────┬───────┘  │
│       │              │                │          │
│  ┌────┴──────────────┴────────────────┴───────┐  │
│  │              pkg/ (Go packages)            │  │
│  │  agent · channel · cost · cron · mcp       │  │
│  │  provider · runtime · secret · workspace   │  │
│  └────────────────────┬───────────────────────┘  │
│                       │                          │
│  ┌────────────────────┴───────────────────────┐  │
│  │           Agent Runtimes                   │  │
│  │     tmux sessions │ Docker containers      │  │
│  │     git worktrees │ isolated .bc/ state    │  │
│  └────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘
                        │
            ┌───────────┼───────────┐
            │           │           │
         Claude      Gemini     Cursor ...

• Single binary — CLI, server, web UI, MCP all in one
• SQLite storage — zero external dependencies
• Agent isolation — each agent gets its own git worktree and tmux/Docker session
• Gateway integrations — Slack, Telegram, Discord for notifications

Configuration

Workspace config lives in .bc/settings.json:

{
  "version": "2",
  "server": {
    "host": "127.0.0.1",
    "port": 9374
  },
  "providers": {
    "default": "claude"
  },
  "runtime": {
    "default": "tmux"
  },
  "storage": {
    "default": "sqlite"
  }
}

Development

make build            # Build everything
make test             # Run all tests
make lint             # Run linters
make check            # Full quality gate
make run-bc           # Run from source
make run-web          # Web UI dev server (hot reload)

See make help for all targets.

Contributing

Contributions welcome. Please run make check before submitting PRs.

License

MIT