CLI Reference

Complete command reference for the CCCC CLI.

Global Commands

cccc

Start the daemon and Web UI together.

cccc                    # Start daemon + Web UI
cccc --help             # Show help

cccc doctor

Check your environment and diagnose issues.

cccc doctor             # Full environment check

cccc runtime list

List available agent runtimes.

cccc runtime list       # List detected runtimes
cccc runtime list --all # List all supported runtimes

Daemon Commands

cccc daemon

Manage the CCCC daemon.

cccc daemon status      # Check daemon status
cccc daemon start       # Start daemon
cccc daemon stop        # Stop daemon

Notes:

• cccc daemon start refuses to spawn a duplicate daemon if the pid-file process is still alive but IPC is not responding.
• In that case, run cccc daemon stop (or clean stale runtime state) before retrying start.

Group Commands

cccc attach

Create or attach to a working group.

cccc attach .           # Attach current directory as scope
cccc attach /path/to/project

cccc groups

List all working groups.

cccc groups             # List groups

cccc use

Switch to a different working group.

cccc use <group_id>     # Switch to group

cccc group

Manage the current working group.

cccc group create --title "my-group"         # Create group
cccc group show <group_id>                   # Show group metadata
cccc group update --group <id> --title "..." # Update title/topic
cccc group use <group_id> .                  # Set active scope
cccc group start --group <id>                # Start group actors
cccc group stop --group <id>                 # Stop group actors
cccc group set-state idle --group <id>       # Set state: active/idle/paused/stopped
cccc group detach-scope <scope_key> --group <id>
cccc group delete --group <id> --confirm <id>

Actor Commands

cccc actor add

Add a new actor to the group.

cccc actor add <actor_id> --runtime claude
cccc actor add <actor_id> --runtime codex
cccc actor add <actor_id> --runtime custom --command "my-agent"

Options:

• --runtime: Agent runtime (claude, codex, droid, etc.)
• --command: Custom command (for custom runtime)
• --runner: Runner type (pty or headless)
• --title: Display title

cccc actor

Manage actors.

cccc actor list                    # List actors
cccc actor start <actor_id>        # Start actor
cccc actor stop <actor_id>         # Stop actor
cccc actor restart <actor_id>      # Restart actor
cccc actor remove <actor_id>       # Remove actor
cccc actor update <actor_id> ...   # Update actor settings
cccc actor secrets <actor_id> ...  # Manage runtime-only secrets

Message Commands

cccc send

Send a message.

cccc send "Hello"                  # No --to: default recipient policy applies (default: foreman)
cccc send "Hello" --to @all        # Explicit broadcast
cccc send "Hello" --to @foreman    # Send to foreman
cccc send "Hello" --to peer-1      # Send to specific actor

cccc reply

Reply to a message.

cccc reply <event_id> "Reply text"

cccc inbox

View inbox.

cccc inbox --actor-id <id>         # View actor unread messages
cccc inbox --actor-id <id> --mark-read

cccc tail

Tail the ledger.

cccc tail                          # Show recent events
cccc tail -n 50                    # Show last 50 events
cccc tail -f                       # Follow new events

IM Bridge Commands

cccc im

Manage IM Bridge.

cccc im set telegram --token-env TELEGRAM_BOT_TOKEN
cccc im set slack --bot-token-env SLACK_BOT_TOKEN --app-token-env SLACK_APP_TOKEN
cccc im set discord --token-env DISCORD_BOT_TOKEN
cccc im set feishu --app-key-env FEISHU_APP_ID --app-secret-env FEISHU_APP_SECRET
cccc im set dingtalk --app-key-env DINGTALK_APP_KEY --app-secret-env DINGTALK_APP_SECRET --robot-code-env DINGTALK_ROBOT_CODE

cccc im start                      # Start IM bridge
cccc im stop                       # Stop IM bridge
cccc im status                     # Check IM bridge status
cccc im logs                       # View IM bridge logs
cccc im logs -f                    # Follow IM bridge logs

Setup Commands

cccc setup

Configure MCP for an agent runtime.

cccc setup --runtime claude        # Auto-configure for Claude Code
cccc setup --runtime codex         # Auto-configure for Codex
cccc setup --runtime cursor        # Print manual config instructions

Web Commands

cccc web

Start only the Web UI (daemon must be running).

cccc web                           # Start Web UI
cccc web --port 9000               # Custom port

MCP Commands

cccc mcp

Start the MCP server (for agent integration).

cccc mcp                           # Start MCP server (stdio mode)

Environment Variables

Variable	Default	Description
CCCC_HOME	~/.cccc	Runtime home directory
CCCC_WEB_HOST	127.0.0.1	Web UI bind address
CCCC_WEB_PORT	8848	Web UI port
CCCC_WEB_TOKEN	(none)	Authentication token for Web UI
CCCC_LOG_LEVEL	INFO	Log level