CCLink Agent

Remote coding agent that bridges Claude Code CLI with the CCLink mobile app via instant messaging.

Prerequisites

• Node.js >= 16
• Claude Code CLI installed and authenticated (claude --version)
• macOS or Linux

Install

npm install -g chatcc-agent

Usage

First-time setup

chatcc start

You will be prompted for a Setup Code. Get it from the CCLink app:

1. Open CCLink app → Settings → "Add Agent"
2. Copy the Setup Code (format: CC-XXXXXXXXXXXXXXXX)
3. Paste it into the terminal

After validation, the agent connects automatically. Credentials are saved for subsequent runs.

Commands

chatcc start       # Start (prompts for Setup Code if no credentials)
chatcc status      # Check agent status and credential expiry
chatcc stop        # Stop the daemon
chatcc restart     # Restart the daemon
chatcc code        # Show agent info and paired clients
chatcc add-client  # Add a new paired client
chatcc install     # Register as systemd service (Linux)
chatcc uninstall   # Remove systemd service (Linux)

Configuration

Runtime files are stored in ~/.chatcc/:

| File | Description | |------|-------------| | credentials.json | IM credentials (30-day, auto-renewed) | | paired-clients.json | Paired client list | | agent.pid | Daemon process ID | | agent.log | Daemon log output |

Credentials are obtained via Setup Code and auto-renewed before expiry.

How It Works

CCLink App  <-->  Tencent IM  <-->  CCLink Agent  <-->  Claude Code CLI

The agent runs on your server, receives messages from the CCLink app via Tencent IM, and forwards them to the locally installed Claude Code CLI. Responses stream back in real time.

License

MIT