CCB - Mobile Has Arrived!

A lightweight multi-agent TUI with a stable cross-provider collaboration layer Coordinate Codex, Claude, Gemini, and other CLI agents in visible, controllable workflows you can take over

中文 | English | 日本語 | Français | Deutsch | العربية | Español | Português | 한국어 | Русский

Quick Start · Mobile App · Rich Mode · Configure Agents · User Guide · Developer Guide

Why CCB?

• Stable inter-agent communication for complex collaboration graphs such as A -> B -> C, A,B -> C, and A -> B,C.
• Every agent is a full native terminal with visible layout control and direct takeover.
• The background daemon keeps project state alive even when the foreground UI is closed.
• Hub capability: run multiple CLI providers concurrently from one command.
• Mobile remote controller: cross-provider voice control, file transfer, and remote terminal access.

How to Install

Install or update with npm:

npm install -g @seemseam/ccb

After CCB is installed, use CCB's updater:

ccb update

If npm is not convenient in your environment, download the matching package from Releases, unpack it, and install:

tar -xzf ccb-*.tar.gz
cd ccb-*
./install.sh install

Source install is intended only for development or temporary fallback:

git clone https://github.com/SeemSeam/claude_codex_bridge.git
cd claude_codex_bridge
./install.sh install

Source install links global ccb / ask back to the checkout. Regular users should prefer the npm package.

Quick Start

1. Launch

Run this from your working directory:

ccb

If startup reports that .ccb cannot be created automatically or that the project anchor is missing, create .ccb manually:

mkdir -p .ccb

2. Configure The Workspace

A blank project starts light: CCB opens one main window with a single agent named demo, selecting the first supported CLI available on the machine (Codex, Claude, Gemini, then other providers). It no longer mounts a multi-agent team by default.

Click the ⚙ Settings icon at the top-left of the CCB sidebar to open the local configuration control panel. You can also run ccb config ui from the project directory.

The panel edits windows, pane splits, providers, models, thinking levels, API overrides, workspaces, Rich mode, and sidebar settings. It validates changes before saving and supports reload dry-runs and guarded hot reload. Saving creates .ccb/ccb.config and pins the selected provider and topology for this project.

For an advanced multi-agent topology, edit it visually or create .ccb/ccb.config manually. In v2 [windows], , and ; control vertical stacking and horizontal splits inside each window, so A,B;C,D is close to a four-pane layout.

version = 2

[windows]
main = "main:codex"
work = "worker1:codex(worktree), worker2:claude(worktree)"
review = "reviewer:claude, qa:gemini"

[ui.sidebar]
mode = "every_window"
width = "15%"
bottom_height = 20
agents_height = "50%"
comms_height = "15%"
tips_height = "35%"
comms_limit = 3

Validate the config and start the workspace:

ccb config validate
ccb

3. Collaborate

You can type directly in any agent pane, or let agents collaborate:

/ask reviewer review the latest parser changes and list blocking issues.

Agents can also call /ask during workflow orchestration to delegate and hand off work. Use agent memory or the project-wide shared memory file .ccb/ccb_memory.md for durable coordination.

Mobile Remote Control (Android)

The recommended way to control CCB from a phone can connect to all CCB projects, control each agent, accept voice input, and transfer files.

ccb update mobile

This command guides installation and configuration.

CCB 8.1.2 includes the Flutter CCB Mobile source in mobile/ and publishes the Android APK through GitHub Releases:

• Download CCB Mobile v8.1.2 APK
• App source: mobile/app
• Server gateway source: lib/mobile_gateway

The phone app is a remote controller for real CCB projects running on a server. It can discover mounted projects from the server-wide mobile gateway, switch windows and agents, render agent conversation context, send text through pane-native input, open a terminal view, and upload/download images and documents through the authenticated gateway.

Safety boundary:

• The CCB gateway binds only to loopback, for example 127.0.0.1:8787.
• Remote access uses Tailscale Serve, not Tailscale Funnel.
• CCB does not store Tailscale passwords, OAuth tokens, admin API tokens, or automatically modify tailnet ACLs/grants.
• The phone receives only the scopes authorized by the pairing profile, such as view, content, terminal, file upload, and file download.

Rich Media Terminal

Browse file trees, open files, edit documents, and preview media inside the terminal.

ccb update rich

After rich mode is enabled, plain ccb opens the rich WezTerm launcher automatically unless it is already running inside a CCB-managed rich WezTerm session. Run ccb uninstall rich to return to normal terminal startup.

Agent Roles Spec And Role Catalog

CCB supports Agent Roles Spec, a host-neutral specification for packaging specialist agents. It can bundle skills, memory, and tool dependencies into installable, mountable, and removable Role Packs. That repository also serves as the public role catalog.