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/mycel/main/scripts/install.sh | bash

# Homebrew
brew install rpuneet/mycel/mycel

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

# From source
git clone https://github.com/rpuneet/mycel && cd mycel && 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

Agent	Status
Claude Code	Fully supported
Gemini CLI	Fully supported
Cursor	Supported
Codex	Supported
Custom	Any CLI tool via provider config

Commands

Core

Command	Description
bc	Open TUI dashboard
bc init	Initialize workspace
bc up	Start server (foreground)
bc up -d	Start server (daemon)
bc down	Stop server
bc status	Show agent status
bc doctor	Diagnose workspace issues

Agents

Command	Description
bc agent create [name]	Create agent with role and tool
bc agent list	List all agents
bc agent attach <agent>	Attach to agent's tmux session
bc agent peek <agent>	Watch agent output
bc agent send <agent> <msg>	Send message to agent
bc agent stop <agent>	Stop agent
bc agent delete <agent>	Delete agent

Channels

Command	Description
bc channel list	List channels
bc channel create <name>	Create channel
bc channel send <ch> <msg>	Send message
bc channel history <ch>	View history

Cost & Scheduling

Command	Description
bc cost show	Show cost records
bc cost budget show	Budget status
bc cron add <name>	Schedule recurring task
bc cron list	List scheduled tasks

Configuration

Command	Description
bc config show	Show configuration
bc config set <key> <val>	Set config value
bc secret set <name>	Store encrypted secret
bc tool list	List available tools
bc mcp list	List MCP servers
bc role list	List agent roles

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