Collaborative Coding Agent

The Collaborative Coding Agent enables you to connect your local development environment (VS Code, terminal, ports) to the Collaborative Coding Cloud Workspace.

Installation

Option 1: NPM Package (Recommended)

You can install and run the agent globally:

npm install -g @collab-cloud/agent

Then simply run:

CCW              # Auto-starts, prompts for key
CCW start        # Explicit start command
CCW start --key <YOUR_KEY>  # Start with key
CCW stop         # Stop the running agent

Option 2: Standalone Binary

Download the binary for your operating system from the Releases page.

• Windows: agent-win.exe
• macOS: agent-macos
• Linux: agent-linux

Then run it:

./agent-win.exe start

Usage

Starting the Agent

1. Get your Workspace Key:

   • Go to your Workspace Dashboard.
   • Click on "Connect Local Agent".
   • Copy the provided key.

2. Run the Agent:

   CCW start

   Or provide the key directly:

   CCW start --key ccw_your_key_here

3. Live Status Display: Once started, you'll see real-time status updates:

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   ✓ Status: Connected
   🆔 Agent ID: 7WPOlTgyoX4bBdPhAAAF
   ⏱️  Uptime: 00:05:23
   🐳 Containers: 1 running
   📦 Requests proxied: 47
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Press Ctrl+C or run 'CCW stop' to exit

Stopping the Agent

CCW stop

Or press Ctrl+C in the running terminal.

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build binaries
npm run build:binary