cccc

CCCC

Coordinate your coding agents like a group chat

Local-first coordination for coding agents: durable Group history, explicit message status, cross-instance collaboration, and access from the Web, the terminal and IM.

Connect the Claude Code, Codex, Pi and OpenCode sessions you already run, or let CCCC run agents for you, as one persistent team.

One install command. No Rust toolchain, database server, message broker or Docker required.

English | 中文 | 日本語

Quick start · Documentation · Community

What CCCC does

When several coding agents share work, you need to know who owns a task, whether a message reached its recipient, and what survives a restart. CCCC keeps that in one place:

• A durable Group chat. Each Group records messages and events in an append-only ledger; tasks and shared context are stored as well.
• Explicit delivery. Messages go out as Send, Send + Reply or Mail, and delivery, read and reply are recorded as separate facts.
• Your sessions or CCCC’s. Connect sessions you already run, or let CCCC manage agents on many CLI and Web runtimes, in the same Group.
• One control plane. The Web UI, the terminal interface, the CLI, MCP tools and IM bridges share the daemon’s state.
• Chet, a global assistant you can write or talk to.
• CCCC Connect links Groups across machines and teams; each instance keeps its own state.
• Local-first. Runtime state stays in CCCC_HOME (default ~/.cccc/), outside your repository.

What’s new in 0.4.51

• One panel for what you open. Workspace files, message attachments and Presentation slots open as tabs in one panel beside or over the messages. Keep several open, find one under All, put two side by side to compare them, close several at once and undo it. A file with unsaved edits asks before it closes, and new messages that arrive while the panel covers the chat count as unread.
• PDFs scroll on phones and tablets. On touch devices, and in browsers without a PDF viewer, PDFs from messages, the workspace and Presentation slots served by this CCCC open in a reader inside the page that scrolls through the pages and zooms. It cannot select or search text; message attachments and workspace files keep Download.
• A note with your choice. When an agent asks you a question with options, + Add a note (optional) sends a few words with the option you choose, in one reply.
• DeepSeek connection settings. A DeepSeek member’s API address, model and key have their own form, both when you add the member and in its Runtime settings; a saved key is never shown again. The default model is now deepseek-flash. When a turn fails, the key and other private values the member was started with are replaced wherever the error repeats them in full, before it is saved.
• Credentials stay off proxies. When the address is a literal loopback address, these calls no longer go through a system proxy: the daemon’s and the CLI’s calls to the local Web, which carry the admin token, and calls to a local MCP server, Mattermost, Codex Voice, Connect peer, skill URL or DeepSeek gateway.
• Skill source URLs are protected. For a skill installed from a direct HTTP(S) URL, CCCC no longer saves or shows the URL’s username, password, query string or fragment. A secret in the URL’s path is not removed, and entries saved before stay as they are on disk.
• Message text in a proportional font. Messages use IBM Plex Sans by default, with Chinese and Japanese in your system’s fonts; code stays monospace. Body font offers Sans, Mono and Pixel, and a font you chose stays.
• A quieter daemon with Grok web model members. It no longer rereads the whole Group history every two seconds.
• Old search results are marked. SkillsMP search results that were never imported are no longer recommended and show as unverified.
• The Terminal history button and panel are removed. Scroll the runtime’s own terminal to look back, though a runtime that redraws its screen in place may keep no earlier output there; agents can still read retained output through cccc_terminal.

Upgrade notes. Before upgrading, let sends and recordings finish, restore or discard waiting sends, then send or copy every unsent draft and save unsaved edits in Files: all of these live only in the open page. Check whether a message already arrived before sending it again. Then restart the daemon and Web and reload open pages. If you use a system proxy whose NO_PROXY does not exclude loopback, create a new Web admin token, delete the old one, and replace other credentials sent to local services. If a skill URL you installed from held credentials, replace them.

Details: 0.4.51 release notes.

Quick start

Install

# macOS / Linux
curl -fsSL https://chesterra.github.io/cccc/install.sh | sh

# Windows CMD or PowerShell
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; Invoke-RestMethod 'https://chesterra.github.io/cccc/install.ps1' | Invoke-Expression"

# Or through pip: the same native executable in a platform wheel
python -m pip install -U "cccc-pair>=0.4.36"

CCCC runs on Linux x86-64 (glibc 2.28+), Apple Silicon macOS 11+ and Windows x86-64. See Installation and upgrades for more.

Launch

cccc

cccc starts the daemon and the Web UI. In an interactive terminal it also opens a status panel; type / for its commands, and /quit or Ctrl+C stops what this launch started. Open http://127.0.0.1:8848 for the full Web UI; local use needs no password.

On servers, in containers and in scripts, use cccc --headless (the same as cccc web). If port 8848 is in use, choose another with cccc --port 9000. cccc doctor checks the installation and the agent CLIs it detects.

Choose how agents join

Both kinds can work in the same Group. Steps: Connect the sessions you already run or Let CCCC run agents.

Connect the sessions you already run

Codex, Claude Code, Pi and OpenCode V2 sessions that you started yourself can join Groups and contact each other through the local daemon. CCCC imports no history and needs no provider API key. This is experimental: it was tested on Linux and WSL, and macOS and native Windows still need acceptance testing. Antigravity sessions cannot connect this way yet.

Requirements. Codex 0.163.0, Claude Code 2.1.306, Pi 1.4.0 or OpenCode V2 2.1.4, or later, on the machine running CCCC, as the same OS user and with the same CCCC_HOME as the daemon. Enable this only if your local sessions may receive work from each other and from this instance’s administrator. Codex also needs its shared app-server: add this to $CODEX_HOME/config.toml (normally ~/.codex/config.toml), inside the existing [features] table if there is one:

[features]
daemon_auto_start = true

1. Enable each app once. In the cccc status panel, type /setup, tick the apps with Enter, choose Continue, then Connect. Or run cccc sessions enable --runtime codex (or claude, pi, opencode).
2. Load it in the app.
   • Codex: restart it, approve the CCCC hooks when asked (/hooks), then send any message.
   • Claude Code: restart it (claude --resume picks the conversation to continue), then send any message. Plugin Monitor must be enabled.
   • Pi: run /reload, or start Pi.
   • OpenCode V2: reopen the original session; a blank new session needs a first message.
3. Check with cccc sessions list. Add --include-offline to also see registered sessions that cannot receive right now.
4. Connect them to a Group. In the Web UI, choose Connect sessions above the Group list (an icon under New when the sidebar is collapsed). In Connect existing sessions, pick a Target Group and choose Connect to Group, or pick + New Group and choose Create & connect. For a new Group with several sessions, choose the Foreman under New Group defaults. Setup steps for each app are under App to connect, and when a session is marked Unavailable to receive, the dialog offers See troubleshooting.

You can also ask from inside a session; CCCC creates or reuses a Group for both:

Use CCCC to contact the Codex session in /path/to/project about the current task. Use Send + Reply and ask it to reply through CCCC using Send. If several sessions match, ask me to choose.

The app keeps its tool approvals, so a CCCC tool call can wait for you in its terminal. Only what a session sends through CCCC reaches the Group, not its ordinary terminal output. Pause CCCC access and Resume CCCC access change one Group membership without touching the app. cccc sessions disable --runtime codex (or claude, pi, opencode) removes only what this CCCC installation registered.

After upgrading CCCC, reload the integration in each app. The native sessions guide also covers the CLI commands, resuming conversations, recovery and limits.

Let CCCC run agents

Install and sign in to the agent CLIs you want to use first. In the Web UI:

1. Choose New in the sidebar, pick the Project Directory on the machine running CCCC (Browse helps), then Create Group.
2. Choose + (Add an agent) in the members’ row above the message box, pick a detected Runtime, enter an Agent ID and choose Add Agent. The first agent becomes the foreman; later ones are peers.
3. Open the Group status button in the header and choose Start Group.
4. Write in Messages and choose Send (Ctrl+Enter, or Cmd+Enter on a Mac).

From the command line, with CCCC running (for example cccc in another terminal):

cd /path/to/your/repo
cccc attach .                                # create a Group for this folder and make it active
cccc actor add lead --runtime claude         # the first agent becomes the foreman
cccc actor add implementer --runtime codex   # a peer
cccc group start                             # start the Group's enabled agents
cccc send "Please inspect the repo and propose the first safe task." --to "@foreman"
cccc tracked-send "Please take the first concrete task and reply with validation evidence." \
  --to implementer \
  --title "First concrete task" \
  --outcome "The change and validation evidence are reported"

Claude Code and Codex receive CCCC’s MCP tools when CCCC starts them, so no cccc setup step is needed. The CLI calls agents actor. In PowerShell, keep "@foreman" in quotes, since a bare @ starts splatting, and enter tracked-send on one line: the trailing \ continues a line only in POSIX shells.

On first launch, Claude may ask you to trust the workspace or accept its --dangerously-skip-permissions disclaimer, and the agent shows Awaiting your confirmation in the terminal. Answer in its terminal in the Web UI (Open confirmation terminal takes you there); CCCC never answers for you. If you decline, choose Launch or Relaunch to try again.

Approvals. Many runtimes start with approval prompts bypassed, for example claude --dangerously-skip-permissions. Review each agent’s command in its settings and the autonomy defaults.

You should see both agents in the members’ row, the foreman’s reply in Messages and the tracked request with a linked task. If an agent does not start, open it to read the error, check that its CLI is installed and signed in, and run cccc doctor; see also the FAQ.

Chet, the global assistant

Chet is one assistant for the whole CCCC instance, outside every Group’s member list. Open it with the Chet control below the Group list and type, or choose Start voice beside it for a live call. A Group selected when you send is included as context, not as a permission boundary.

• Runtime: set it under Settings → This instance → Voice → Chet → Runtime. CCCC keeps Chet’s history of inputs, transcripts and results on the machine running CCCC; what you send still goes to the model and voice providers you configure.
• Voice (experimental): Codex Voice uses codex login; Grok Voice uses grok login and needs grok on CCCC’s PATH. Neither needs an extra API key. Reported Grok Voice pitch and timbre drift is not confirmed fixed.
• In Groups: members reach Chet by choosing @chet as the only recipient, with Send or Send + Reply but not Mail.
• Limits: messages from every Group enter Chet’s one session, and keeping them apart is an instruction to the model, not isolation. Chet does not forward between Groups or send through CCCC Connect.

Voice Secretary, under Settings → This instance → Voice → Voice Secretary, is a separate global service that turns recordings into documents, prompt drafts or answers for each Group; all Groups share its conversation. See Chet and the Voice Secretary guide.

Key ideas

Use Mail for updates that can wait, Send when the recipient should know now, and Send + Reply when you need an answer. Use tracked-send for delegated work that needs an owner, an outcome and evidence.

Working in the Web UI

• Messages. @ mentions agents and # mentions Groups. Point at a message for Reply, Forward and copy; its More menu adds quick replies, Pin message and Copy link. On touch screens, More holds every action.
• Tabs. Waiting for you (requests you can answer in place), All, Pinned and User-related. In a filtered view, Show in chat opens a message in the whole conversation.
• Messages and Terminals in the Group header switch views. The terminal view shows up to four agents per page and takes keyboard input.
• Files, Presentation (four pinned slots) and Project Context (Tasks, AGENTS.md, Coordination log, Agent State, Skills).
• Settings and more, then All settings: This group includes Guidance, Automation, Delivery, Messaging and IM Bridge; This instance includes Account, Web Access, Notifications and Voice.
• Appearance. Theme is Light, Dark or Auto (follows the light or dark setting of your system), and the language is English, Chinese or Japanese. More appearance settings has Body font, Message area width (Medium, Wide or Full, on screens 768px and wider), Motion, ‘Waiting for you’ indicators and Text Size (70%, 90%, 100% or 125%).
• Notifications. Settings → This instance → Notifications → Enable notifications, in each browser, over HTTPS or on localhost. On iPhone or iPad (iOS or iPadOS 16.4 or later), add CCCC to the Home Screen first.
• Automation sends bounded reminders for unread Mail, open replies, idle agents and quiet Groups, and runs your interval, recurring or one-time rules.
• Copy Groups exports and imports a Group’s durable state. It leaves out workspace files and the credential files CCCC keeps, but the history and attachments it carries can still hold sensitive content.

Supported runtimes

Each agent can use a different runtime:

CCCC sets up MCP for these runtimes itself, with three exceptions: for Cursor’s terminal, cccc setup --runtime cursor prints a prompt to run inside Cursor; the Web models use a remote MCP connector; and custom is configured by hand. Antigravity’s ACP mode needs a separate login once: cccc setup --runtime antigravity --runtime-mode acp --login. cccc runtime list shows which runtimes are available here (--all adds custom).

The Web models need their own setup. ChatGPT Web uses browser delivery and a remote MCP connector at a public HTTPS URL; its experimental GPT Pro mode attaches a tiny blank PNG. ChatGPT Dots uses ChatGPT’s event-triggered tasks. Grok Bot Web Model uses a Webhook Routine on an existing https://grok.com/bot/<UUID>. See the Supported Runtimes guide, ChatGPT Web, Dots and Grok Bot.

Reach CCCC from anywhere

Remote access

Direct local use needs no Access Token. Before you open the Web UI to other machines, create an Admin Access Token in Settings → This instance → Web Access.

• LAN: cccc --host 0.0.0.0 --port 8848, or the binding saved in Web Access. Under WSL2’s default NAT, also enable mirrored networking or add a Windows forwarding rule.
• Your tunnel or reverse proxy: serve it over HTTPS, for example with cloudflared tunnel --url http://127.0.0.1:8848, and protect forwarding headers as the Web UI guide describes.
• Managed Remote Access (Linux and macOS): link the instance in Settings → This instance → Account and turn on Remote Access in Web Access, or run cccc login and cccc reach on. It installs a pinned cloudflared under CCCC_HOME and uploads neither your repository nor your ledger.

A changed binding applies after Apply now, or after you restart your own supervisor. --host and --port override the saved binding, which overrides CCCC_WEB_HOST and CCCC_WEB_PORT.

IM bridges

cccc im set telegram --token-env TELEGRAM_BOT_TOKEN
cccc im start

Telegram, Slack, Discord, Mattermost, Feishu/Lark, DingTalk, WeCom and Weixin (direct bot chats only) are supported. In the chat, write plain text or /send @foreman <message>; /status shows Group health, and /pause and /resume control that chat’s subscription. See the IM bridge guide.

CCCC Connect

CCCC Connect links Groups across CCCC instances; it is separate from Connect sessions. “Account” means your CCCC account, not a provider login. With an account, each instance also needs a reachable HTTPS address, such as the one Remote Access sets up; linking the account alone does not make it reachable.

Connections carry messages, replies and small files between the selected Groups, not terminals or workspace access, and each instance keeps its own state. Agents find targets with cccc_connect and address them with dst_instance_id and dst_group_id. See the CCCC Connect guide.

Security

• The Web UI is high-privilege. Create an Admin Access Token before any non-local exposure, and use HTTPS for public access.
• Daemon IPC is a trusted local interface without application authentication (a Unix socket or loopback TCP). Do not expose it or share the runtime home with untrusted users.
• Native sessions trust this OS user. Enabled sessions can receive work from each other and from this instance’s administrator; source IDs are not credentials.
• Managed agents often run with approval prompts bypassed. Review their commands before giving them sensitive work.
• IM credentials can be environment-variable references or literal values; prefer references.
• Connection scope is explicit. Opening another instance’s workspace needs that instance’s administrator Access Token.
• Capability allowlists control optional MCP tools. They are not a sandbox for agent processes.

Report vulnerabilities as described in SECURITY.md.

CLI cheat sheet

cccc                         # daemon + Web UI with the status panel (cccc --headless: without it)
cccc doctor                  # installation and environment checks
cccc daemon status           # also: start, stop

cccc attach .                # create a Group for this folder
cccc groups                  # list Groups; cccc use <group_id> makes one active
cccc group start             # start the Group's agents (also: stop)

cccc actor add <agent_id> --runtime <runtime>   # agents are "actor" in the CLI
cccc actor restart <agent_id>                   # also: start, stop; cccc actor list

cccc sessions enable --runtime codex            # or claude, pi, opencode
cccc sessions list
cccc sessions join --group <group_id> --sources <source_id>

cccc send "Please coordinate the next step." --to "@foreman"
cccc tracked-send "Implement the feature." --to <agent_id> --title "Feature" --outcome "Done and validated"
cccc reply <event_id> "Thanks, that looks good."
cccc tail -n 50 -f           # follow the Group's ledger
cccc inbox --actor-id <agent_id>   # read and consume an agent's next Mail batch

cccc runtime list            # runtimes available here (--all adds custom)
cccc setup --runtime <id>    # prepare a runtime's MCP setup explicitly
cccc im start                # also: stop, status

cccc --help describes every command; see also the CLI reference.

For integrators

MCP tools. Agents always see a compact core: cccc_bootstrap, cccc_help, capability search and use, Inbox, messaging, files, cccc_context_get, cccc_coordination, cccc_task, cccc_agent_state and cccc_connect. Other built-in tools, such as cccc_tracked_send, cccc_group, cccc_actor, cccc_repo, cccc_terminal and cccc_automation, are available through cccc_capability_use. Native sessions also get cccc_session to list, message and group other sessions.

SDK. The Python, TypeScript and Rust clients connect to a running cccc; they contain no daemon.

pip install -U cccc-sdk
npm install cccc-sdk
cargo add cccc-sdk

Architecture.

The daemon owns agent lifecycle, delivery and collaboration changes, and the ledger is append-only. The Web UI, terminal interface, CLI, MCP and IM bridges all go through the daemon; the Web process also hosts browser, voice, Chet and IM integrations. See Architecture.

Is CCCC a fit?

CCCC fits several agents sharing a codebase, mixed runtimes such as Claude + Codex + Kimi, long-running Groups supervised from a phone or IM, and Groups that span machines or teams. It works for a single helper, but most of its value comes with several participants, and it is not a DAG workflow orchestrator. It complements native agent teams, parallel task runners and IM assistant gateways rather than replacing them; see the FAQ comparison and Positioning.

Installation and upgrades

Website installer. It downloads a checksum-verified executable from GitHub Releases: the latest stable release, or the one named in CCCC_VERSION. It refuses to overwrite a cccc command it does not own (uninstall that command or set CCCC_INSTALL_DIR), and for the default directory it puts the new command first in your user PATH. In a new terminal, cccc doctor shows which cccc your PATH selects and any conflicts.

pip (cccc-pair>=0.4.36) installs the same executable in a platform wheel. The lower bound stops pip from picking an old Python-only release; there is no Python package or fallback.

Upgrade with cccc update for the website installer, or the pip command for pip. cccc update --check shows the latest release and the installation owner without changing anything. Before a pip upgrade, run cccc daemon stop and close foreground CCCC processes. To switch from pip to the website installer, run python -m pip uninstall cccc-pair first. If an older cccc update stays on 0.4.35, see the upgrade FAQ; the Operations Runbook has a full checklist.

From source, with Rust 1.88+, Node.js 24 with npm, and Python 3.11+ for the archive helper only:

git clone https://github.com/ChesterRa/cccc
cd cccc
./scripts/build_package.sh
./target/release/cccc --version

On Windows, use the x86_64-pc-windows-msvc toolchain and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\build_package.ps1. For a debug build, run cargo run --locked --features standalone -p cccc --bin cccc -- --port 0.

Docker. Run docker compose up -d in docker/, then create an Admin Access Token in Settings → This instance → Web Access before exposing it beyond localhost. The image includes Claude Code, Codex CLI and Factory CLI.

Older versions. CCCC v0.4.37 is the last release for Intel Macs. The tmux-first 0.3.x line is archived at cccc-tmux; uninstall it through its package manager before installing 0.4.x, and keep your data, because reinstalling does not convert 0.3.x sessions into Groups. cccc python, cccc rust and the ccccd alias are retired; use cccc daemon ….

Documentation

Community

Share workflows, ask questions, and connect with other CCCC users:

• Discord: Join the CCCC server
• Telegram: t.me/ccccpair
• Bug reports and feature requests: GitHub Issues

Contributing

Contributions are welcome. Please:

1. Check existing Issues before opening a new one
2. For bugs: include cccc --version, OS, exact commands, and reproduction steps
3. For features: describe the problem, proposed behavior, and operational impact
4. Keep runtime state in CCCC_HOME — never commit it to the repo

See CONTRIBUTING.md for development setup, quality gates, and the pull request process.

License

Apache-2.0