Skip to content
Collective Context

CCC CLI Reference

🚀 Quick Start - Version Management

Section titled “🚀 Quick Start - Version Management”

CCC supports multiple installation modes for different use cases:

Check Current Version

Section titled “Check Current Version”
Terminal window
ccc version

Config-Based Mode Management

Section titled “Config-Based Mode Management”

Set Preferred Mode:

Terminal window
# Configure preferred mode (stored in ~/.config/ccc/config.json)
ccc config mode set dev      # Development mode
ccc config mode set pipx     # Production mode
ccc config mode set apt      # System mode (future)


# Check current configuration
ccc config mode

Switch Between Versions:

Development Mode (Full Features + Session Management):

Terminal window
# Set and activate development mode
ccc config mode set dev
export PATH=/usr/local/bin:$PATH
ccc version  # → v0.3.2-dev, Mode: dev

Production Mode (PyPI Package):

Terminal window
# Set and activate pipx mode
ccc config mode set pipx
export PATH=$HOME/.local/bin:$PATH
ccc version  # → v0.3.2, Mode: pipx

System Mode (Coming Soon):

Terminal window
# Future: apt install ccc
sudo apt install ccc
ccc version  # → Mode: apt

Configuration Management

Section titled “Configuration Management”
Terminal window
ccc config mode                 # Show current configuration
ccc config mode set <mode>      # Set preferred mode
ccc config mode reset           # Reset to auto mode


# Alternative: Legacy version switching
ccc version dev                 # Quick switch to development
ccc version pipx                # Quick switch to pipx

Global Options

Section titled “Global Options”
Terminal window
ccc --version                    # Show version
ccc --help                      # Show help
ccc --config /path/to/config    # Use custom config
ccc --verbose                   # Enable debug output

Agent Management

Section titled “Agent Management”

Agent Commands

Section titled “Agent Commands”
Terminal window
# Start agents
ccc agent start <name>              # Start specific agent
ccc agent start --all               # Start all configured agents
ccc agent start claude-1 --role=architect --temperature=0.3


# Agent status
ccc agent status                    # Show all agent status
ccc agent status <name>            # Show specific agent status
ccc agent list                     # List configured agents


# Stop agents
ccc agent stop <name>              # Stop specific agent
ccc agent stop --all               # Stop all agents
ccc agent restart <name>           # Restart agent

Agent Configuration

Section titled “Agent Configuration”
Terminal window
ccc agent config <name>            # Show agent config
ccc agent config <name> --edit     # Edit agent config
ccc agent create <name>            # Create new agent profile

Tmux Integration

Section titled “Tmux Integration”

Layout Management

Section titled “Layout Management”
Terminal window
ccc tmux init                      # Initialize default layout
ccc tmux init --agents=4           # 4-pane layout
ccc tmux init --layout=orchestra   # Orchestra pattern
ccc tmux init --layout=swarm       # Swarm pattern
ccc tmux init --layout=pipeline    # Pipeline pattern


ccc tmux status                    # Show current tmux state
ccc tmux kill                      # Kill all tmux sessions

Session Management

Section titled “Session Management”
Terminal window
ccc tmux attach                    # Attach to session
ccc tmux detach                    # Detach from session
ccc tmux new --name=project-x      # Create named session

Context Management

Section titled “Context Management”

Context Operations

Section titled “Context Operations”
Terminal window
ccc context init "Project description"    # Initialize context
ccc context show                          # Show current context
ccc context sync --all                    # Sync to all agents
ccc context sync --agent=claude-1        # Sync to specific agent


ccc context save <name>                   # Save context snapshot
ccc context load <name>                   # Load context snapshot
ccc context list                          # List saved contexts

Context Sharing

Section titled “Context Sharing”
Terminal window
ccc context export context.json          # Export to file
ccc context import context.json          # Import from file
ccc context merge <context-name>         # Merge contexts

Workflow Management

Section titled “Workflow Management”

Workflow Control

Section titled “Workflow Control”
Terminal window
ccc workflow start <pattern>             # Start workflow pattern
ccc workflow status                      # Show workflow status
ccc workflow stop                        # Stop current workflow
ccc workflow list                        # List available workflows


ccc workflow create <name>               # Create custom workflow
ccc workflow edit <name>                 # Edit workflow definition

Predefined Workflows

Section titled “Predefined Workflows”
Terminal window
ccc workflow start orchestra            # Start orchestra pattern
ccc workflow start swarm                # Start swarm pattern
ccc workflow start pipeline             # Start pipeline pattern

Monitoring & Logging

Section titled “Monitoring & Logging”

Real-time Monitoring

Section titled “Real-time Monitoring”
Terminal window
ccc monitor                              # Live dashboard
ccc monitor --agent=claude-1             # Agent-specific monitor
ccc monitor --export=metrics.json        # Export metrics


ccc logs                                 # Show all logs
ccc logs --agent=claude-1                # Agent-specific logs
ccc logs --follow                        # Follow logs in real-time
ccc logs --level=error                   # Filter by log level

Performance Metrics

Section titled “Performance Metrics”
Terminal window
ccc metrics                              # Show performance metrics
ccc metrics --export=json                # Export to JSON
ccc metrics --export=csv                 # Export to CSV
ccc metrics --timerange=24h              # Metrics for last 24h

Configuration

Section titled “Configuration”

Config Management

Section titled “Config Management”
Terminal window
ccc config show                          # Show current config
ccc config edit                          # Edit config in editor
ccc config reset                         # Reset to defaults
ccc config validate                      # Validate config syntax

Environment Setup

Section titled “Environment Setup”
Terminal window
ccc setup                               # Interactive setup wizard
ccc setup --api-keys                    # Setup API keys only
ccc setup --tmux                        # Setup tmux integration only

System Commands

Section titled “System Commands”

Health & Diagnostics

Section titled “Health & Diagnostics”
Terminal window
ccc doctor                              # System health check
ccc test connection                     # Test agent connectivity
ccc test api --provider=anthropic       # Test specific API
ccc test tmux                           # Test tmux integration

Maintenance

Section titled “Maintenance”
Terminal window
ccc cleanup                             # Clean temporary files
ccc cache clear                         # Clear internal cache
ccc update                              # Update CCC to latest version

Examples

Section titled “Examples”

Quick Start Sequence

Section titled “Quick Start Sequence”
Terminal window
# 1. Setup
ccc init


# 2. Start 4-agent setup
ccc tmux init --agents=4
ccc agent start --all


# 3. Initialize project
ccc context init "Build web app with authentication"
ccc context sync --all


# 4. Monitor progress
ccc monitor --live

Custom Workflow

Section titled “Custom Workflow”
Terminal window
# Create custom workflow
ccc workflow create my-workflow


# Start with specific context
ccc workflow start my-workflow
ccc context init "Custom project requirements"


# Monitor and export metrics
ccc monitor --export=project-metrics.json