Getting Started

Get CCCC running in 10 minutes.

Choose Your Approach

CCCC offers two ways to get started:

Web UI Quick Start

Recommended for most users

• Visual interface for managing agents
• Point-and-click configuration
• Real-time terminal view
• Mobile-friendly

CLI Quick Start

For terminal enthusiasts

• Full control via command line
• Scriptable and automatable
• Great for CI/CD integration
• Power user features

Prerequisites

Both approaches require:

• Python 3.9+ installed
• At least one AI agent CLI:
  • Claude Code (recommended)
  • Codex CLI
  • GitHub Copilot CLI
  • Or any other supported runtime

Installation

Upgrading from older versions

If you have an older version of cccc-pair installed (e.g., 0.3.x), you must uninstall it first:

# For pipx users
pipx uninstall cccc-pair

# For pip users
pip uninstall cccc-pair

# Remove any leftover binaries if needed
rm -f ~/.local/bin/cccc ~/.local/bin/ccccd

Version 0.4.x Breaking Changes

Version 0.4.x has a completely different command structure from 0.3.x. The old init, run, bridge commands are replaced with attach, daemon, mcp, etc.

From TestPyPI (recommended for RC)

python -m pip install --index-url https://pypi.org/simple \
  --extra-index-url https://test.pypi.org/simple \
  cccc-pair==0.4.0rc17

From Source

git clone https://github.com/dweb-channel/cccc
cd cccc
pip install -e .

Verify Installation

cccc doctor

This checks Python version, available runtimes, and system configuration.

Next Steps

• Web UI Quick Start - Get started with the visual interface
• CLI Quick Start - Get started with the command line