>bc
Documentation

Documentation

Everything you need to orchestrate AI agents from your terminal. CLI-first with a Web UI companion at localhost:9374.

Quick StartCommandsAliasesConfigurationEnv VarsPresets

Quick Start

Installation

Homebrew
brew install bcinfra1/tap/bc
Go Install
go install github.com/bcinfra1/bc@latest
Binary
curl -fsSL https://bc-infra.com/install | sh

Verify installation: bc doctor

Core Concepts

Workspaces

The .bc/ directory stores config, roles, agents, memory, and channel history. Managed via bc ws.

Agents

AI instances with roles, tools, and states. Lifecycle: create → start → work → stop → delete.

Channels

Structured coordination. Default: #eng, #pr, #standup, #leads. Supports @mentions and reactions.

Worktrees

Each agent gets an isolated git worktree. Zero merge conflicts by design.

Memory

Learnings (permanent) + Experiences (time-stamped). Injected on agent spawn across sessions.

Secrets

Encrypted credential management. macOS Keychain, Linux libsecret, or AES-256-GCM fallback.

Cost Tracking

Per-agent token costs, budgets with alerts, and hard stops to prevent runaway spend.

Cron Jobs

Schedule recurring tasks with familiar cron syntax. Automate tests, deploys, reports.

Daemon

Persistent bcd server. Eliminates write contention, enables the Web UI at localhost:9374.

Command Reference

Command Aliases

Every command group has a short alias for faster typing.

Command
Alias
Example
bc workspace
bc ws
bc ws status
bc agent
bc ag
bc ag list
bc channel
bc ch
bc ch send #eng "hello"
bc tool
bc tl
bc tl list
bc secret
bc sec
bc sec create API_KEY
bc cost
bc co
bc co usage --monthly
bc cron
bc cr
bc cr list
bc role
bc rl
bc rl show engineer
bc doctor
bc dr
bc dr fix
bc daemon
bcd
bcd

Configuration

Manage config via bc ws config or edit .bc/config.toml directly.

.bc/config.toml
[workspace]
name = "my-project"
version = 2

[user]
nickname = "@yourname"

[providers]
default = "claude"

[providers.claude]
command = "claude"
enabled = true

[providers.gemini]
command = "gemini"
enabled = true

[runtime]
backend = "tmux"     # or "docker"

Environment Variables

Automatically set in each agent's session:

Variable
Description
BC_AGENT_ID
Unique identifier for the agent
BC_AGENT_ROLE
The agent's assigned role (engineer, manager, etc.)
BC_WORKSPACE
Path to the .bc/ workspace directory
BC_AGENT_WORKTREE
Path to the agent's isolated git worktree
BC_BIN
Path to the bc binary
BC_ROOT
Root directory of the bc workspace
NO_COLOR
Disables color output in agent sessions

Init Presets

solo

Just me and my agents

Creates: 1 engineer
bc init --preset solo
small-team

A few engineers with a lead

Creates: 1 manager + 2-3 engineers
bc init --preset small-team
full-team

PM, managers, engineers, QA

Creates: PM + managers + engineers + QA + UX
bc init --preset full-team

Explore the full CLI reference above, or join the beta to get hands-on.

Request Early Access