bc

bc - AI Agent Orchestration for Software Development

Orchestration for AI agents. Coordinate teams of AI agents working together on your codebase.

bc is a CLI-first orchestration system for coordinating teams of AI agents to work on software development projects. It provides a structured, observable, and persistent environment for AI-driven engineering.

Multi-agent orchestration: initialize workspace, spawn engineers, coordinate via channels, track costs

Core Philosophy

• CLI-First: Every feature is accessible and scriptable through the bc command line.
• Agent Agnostic: Works with any AI agent that can run in a terminal (Claude Code, Cursor, Codex, Gemini).
• Organic Growth: Start with a single root agent and grow your team conversationally.
• Isolated Workspaces: Each agent operates in its own git worktree for conflict-free development.

Why bc?

Supported AI Agents

bc works with any AI agent that runs in a terminal. Use --tool to specify:

bc agent create worker-01 --tool claude    # default
bc agent create worker-01 --tool gemini
bc agent create worker-01 --tool cursor

Installation

Quick Install (coming soon)

# Homebrew (macOS/Linux) - coming soon
brew install rpuneet/tap/bc

# Or build from source
git clone https://github.com/rpuneet/bc && cd bc && make install

Prerequisites

• Go 1.25+
• tmux
• A configured AI agent tool (e.g., Claude Code, Cursor)

Build from Source

git clone https://github.com/rpuneet/bc
cd bc
make build
make install

Shell Completions

Enable tab completion for bc commands, agent names, and channel names:

# Bash
bc completion bash > /etc/bash_completion.d/bc
# or on macOS with Homebrew:
bc completion bash > $(brew --prefix)/etc/bash_completion.d/bc

# Zsh (add to fpath)
bc completion zsh > "${fpath[1]}/_bc"
# or for Oh My Zsh:
bc completion zsh > ~/.oh-my-zsh/completions/_bc

# Fish
bc completion fish > ~/.config/fish/completions/bc.fish

Quick Start

# 1. Run bc - prompts to initialize if no workspace exists
bc

# 2. Or explicitly initialize
bc init

# 3. Start the root agent
bc up

# 4. Open the TUI dashboard
bc home

# 5. Check status
bc status

# 6. Create an engineer agent
bc agent create --role engineer

# 7. Send work to the agent
bc agent send swift-falcon "Implement the login feature"

# 8. Stop all agents
bc down

Smart Default: Running bc with no arguments opens the TUI dashboard if a workspace exists, or prompts you to initialize one if not.

Commands

Workspace Lifecycle

Agent Management

Agent Reporting

Communication

Teams

Roles

Scheduled Tasks (Demons)

Background Processes

| bc memory clear [agent] | Clear agent memory | | bc memory export [agent] | Export memory to JSON | | bc memory import <file> | Import memories from file |

Configuration

Cost Tracking

Worktrees

Event Log

Other

Configuration

Configuration is stored in .bc/settings.json. Key settings:

{
  "user": {
    "name": "@yourname"
  },
  "server": {
    "host": "127.0.0.1",
    "port": 9374,
    "cors_origin": "*"
  },
  "providers": {
    "default": "claude",
    "providers": {
      "claude": {
        "command": "claude --dangerously-skip-permissions"
      },
      "gemini": {
        "command": "gemini --yolo"
      },
      "cursor": {
        "command": "cursor-agent --force --print"
      }
    }
  },
  "runtime": {
    "default": "docker",
    "docker": {
      "image": "bc-agent:latest",
      "cpus": 2,
      "memory_mb": 4096
    },
    "tmux": {
      "session_prefix": "bc",
      "history_limit": 10000,
      "default_shell": "/bin/bash"
    }
  },
  "storage": {
    "default": "sqlite",
    "sqlite": {
      "path": ".bc"
    }
  },
  "cron": {
    "poll_interval_seconds": 30,
    "job_timeout_seconds": 300
  }
}

User Nickname

Your nickname is displayed in channel messages when sending from the CLI:

# Set your nickname (must start with @, max 15 chars)
bc config set user.nickname @alice

# Messages now show your nickname
bc channel send eng "Hello team!"
# Output: [@alice] Hello team!

TUI Features

The bc home dashboard provides a full terminal UI with:

• Responsive Layout: Works at minimum 80x24 terminal size
• 14 Views: Dashboard, Agents, Channels, Costs, Commands, Roles, Logs, Worktrees, Workspaces, Demons, Processes, Memory, Routing, Help
• Command Palette: Quick access to all actions via Ctrl+K
• Keyboard Navigation: Number keys for views, Tab to cycle, j/k in drawer/lists
• Channel Features:
  • @mention autocomplete with Tab completion
  • Role-based name colors and emoji prefixes
  • Arrow key scrolling in message history
• Activity Timeline: Real-time agent activity on dashboard

Keyboard Shortcuts

Contributing

Contributions welcome! See CONTRIBUTING.md for details.