Overview
cc-connect is a Go daemon that sits between a coding agent already installed on your machine and a chat platform you already use. The agent keeps running locally, with your repositories, your credentials and your shell; the chat app becomes its interface. That means you can inspect or modify code, troubleshoot a failure, run commands and kick off automation from your phone, without exposing the machine to the internet — most supported platforms connect outbound over WebSocket, long polling or socket mode, so no public IP is required.
Agent coverage is broad: Claude Code, Codex, Cursor Agent, Gemini CLI, Qoder CLI, OpenCode (Crush), iFlow CLI, Kimi CLI, Pi and GitHub Copilot are supported directly, plus anything that speaks the Agent Client Protocol (ACP) — which is how Devin is supported. Goose and Aider are listed as planned. Platform coverage runs to Feishu/Lark, WPS Xiezuo, DingTalk, Slack, Telegram, Discord, WeChat Work, Weibo, LINE, QQ (NapCat/OneBot), the official QQ Bot, Matrix and personal WeChat via ilink; LINE is the one that needs a public webhook URL.
Control happens through slash commands in the chat: /model to switch models, /reasoning to tune reasoning effort, /mode to change permission mode, /memory to read and write the agent's instruction files, and /dir <path> to change where the next session starts (with /dir <number> and /dir - for history jumps). Privileged commands such as /dir and /shell are gated on an admin_from list of user IDs configured per project; /whoami and /status report the ID you are calling from. A /dir reset restores the configured work_dir and clears the persisted override.
Beyond one agent in one chat, it handles multi-bot relay — bind several bots in a group chat and let them talk to each other, so you can ask Claude something and pull in Gemini on the same thread. One process serves multiple projects, each with its own agent and platform pairing. Scheduled tasks are written in natural language ("every day at 6am, summarize GitHub trending"). Voice messages and screenshots are handled with STT/TTS and multimodal forwarding, and the interface ships in English, Simplified and Traditional Chinese, Japanese and Spanish.
What it does
- Bridges 10+ local coding agents — Claude Code, Codex, Cursor Agent, Gemini CLI, Kimi CLI, OpenCode, Qoder, iFlow, Pi, Copilot — plus any ACP-compatible agent
- 13 chat platforms including Slack, Telegram, Discord, Matrix, Feishu, DingTalk and WeChat Work; most need no public IP
- Slash-command control from chat: /model, /reasoning, /mode, /memory, /dir, /status, /whoami
- Multi-bot relay — several agents in one group chat, able to answer each other
- Multi-project: one process, several projects, each with its own agent and platform pairing
- Natural-language scheduled tasks
- Voice and image input with STT/TTS and multimodal forwarding
- Web admin UI for visual configuration, and a five-language interface
Getting started
Order matters: cc-connect bridges an agent CLI, so install and authenticate at least one agent first. Starting cc-connect without one exits with an error such as "claudecode: claude CLI not found in PATH" and the web UI never comes up.
Install an agent CLI first
Pick at least one and authenticate it.
brew install --cask claude-code # macOS / Linux Homebrew
# or
npm install -g @anthropic-ai/claude-code # any platform
npm install -g @openai/codex # OpenAI CodexInstall cc-connect
npm, Homebrew, a release binary, or build from source with Go 1.22+.
npm install -g cc-connect
# or
brew install cc-connect
# or build from source
git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make buildConfigure
cc-connect web opens the browser dashboard where you create projects, add platforms and manage providers — note it only configures and opens the browser, you still start the service separately. To configure by hand instead, copy the example TOML.
cc-connect web
# or manual configuration
mkdir -p ~/.cc-connect
cp config.example.toml ~/.cc-connect/config.toml
vim ~/.cc-connect/config.tomlRun and upgrade
Start the daemon, then chat with your agent from the platform you configured. Binary installs can self-update.
./cc-connect
cc-connect update # stable
cc-connect update --pre # include pre-releasesCommands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Checking on a long-running coding agent from your phone while away from the desk
- Letting a team drive a shared coding agent from a Slack or Feishu channel
- Running scheduled agent jobs described in plain language, with output delivered to chat
- Comparing two agents' answers side by side in one group conversation via multi-bot relay
How cc-connect compares
cc-connect alongside other open-source coding-agent harnesses & runtimes tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| CC Switch | ★ 133k | A cross-platform desktop app that manages provider configuration for eight coding-agent CLIs from one place, with a local failover proxy, MCP and skill management, and spend tracking. |
| Oh My OpenAgent | ★ 69.1k | Opinionated agent bundle for OpenCode and Codex CLI that ships preconfigured sub-agents, lifecycle hooks and built-in MCP servers behind a single ultrawork command. |
| oh-my-claudecode | ★ 39.2k | A plugin and CLI that adds multi-agent orchestration to Claude Code: staged autopilot workflows, parallel tmux workers, and advisors that route a second opinion to Codex, Gemini, Grok or Cursor. |
| herdr | ★ 39k | A single-binary terminal multiplexer built for coding agents: persistent sessions across local and SSH machines, per-pane working/blocked/idle status, and a socket API agents drive themselves. |
| AionUi | ★ 32.9k | An open-source desktop workspace that pairs a built-in agent engine with dozens of external CLI agents, adding scheduled runs, MCP tools and remote access from a WebUI or chat apps. |
| cmux | ★ 27.2k | A Ghostty-based macOS terminal built around coding agents: vertical tabs that show git branch, PR status and ports, attention notifications when an agent needs you, and a scriptable built-in browser. |
| cc-connect | ★ 15.5k | Run your local coding agent from Slack, Telegram or Feishu instead of a terminal |
| Claude Code Haha | ★ 14.5k | A cross-platform desktop workspace for Claude Code: multi-session workspaces, worktree launch, diff review, a built-in browser preview, GUI permission approval, per-session model choice and visual MCP and subagent managers. |