# Stable
npm install -g cc-connect

# Beta (includes personal WeChat / Weixin ilink and other beta features)
npm install -g cc-connect@beta

# Linux amd64
curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-linux-amd64
chmod +x cc-connect
sudo mv cc-connect /usr/local/bin/

# macOS arm64
curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-darwin-arm64
chmod +x cc-connect
sudo mv cc-connect /usr/local/bin/

git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make build
# binary appears at ./bin/cc-connect

cc-connect update          # stable
cc-connect update --pre    # beta / pre-release

Follow https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md to install and configure cc-connect.

mkdir -p ~/.cc-connect
cp config.example.toml ~/.cc-connect/config.toml

[project.my-project]
name        = "my-project"
work_dir    = "/home/user/myproject"
data_dir    = "/home/user/.cc-connect/data"
admin_from  = "123456789"          # Your Telegram user ID

[project.my-project.agent]
type = "claude-code"               # claude-code | codex | cursor | gemini | qoder | opencode | iflow

[project.my-project.platform]
type  = "telegram"
token = "$TELEGRAM_BOT_TOKEN"      # set via env or paste value

# Project 1: Claude on Telegram
[project.dev]
name     = "dev"
work_dir = "/home/user/project-a"
data_dir = "/home/user/.cc-connect/data/dev"

[project.dev.agent]
type = "claude-code"

[project.dev.platform]
type  = "telegram"
token = "$TELEGRAM_BOT_TOKEN"

# Project 2: Gemini on Feishu
[project.research]
name     = "research"
work_dir = "/home/user/project-b"
data_dir = "/home/user/.cc-connect/data/research"

[project.research.agent]
type = "gemini"

[project.research.platform]
type           = "feishu"
app_id         = "$FEISHU_APP_ID"
app_secret     = "$FEISHU_APP_SECRET"
verification_token = "$FEISHU_VERIFICATION_TOKEN"

[project.mybot.platform]
type  = "telegram"
token = "$TELEGRAM_BOT_TOKEN"
# Get token from @BotFather on Telegram
# No public IP required — uses long polling

[project.mybot.platform]
type               = "feishu"
app_id             = "$FEISHU_APP_ID"
app_secret         = "$FEISHU_APP_SECRET"
verification_token = "$FEISHU_VERIFICATION_TOKEN"
# Uses WebSocket — no public IP needed
# Set up at https://open.feishu.cn/

[project.mybot.platform]
type              = "slack"
bot_token         = "$SLACK_BOT_TOKEN"
app_token         = "$SLACK_APP_TOKEN"
# app_token must start with xapp- (Socket Mode)
# Enable Socket Mode in your Slack app settings

[project.mybot.platform]
type  = "discord"
token = "$DISCORD_BOT_TOKEN"
# Uses Discord Gateway — no public IP needed

[project.mybot.platform]
type       = "dingtalk"
client_id  = "$DINGTALK_CLIENT_ID"
client_secret = "$DINGTALK_CLIENT_SECRET"
# Uses DingTalk Stream — no public IP needed

[project.mybot.platform]
type           = "wecom"
corp_id        = "$WECOM_CORP_ID"
agent_id       = "$WECOM_AGENT_ID"
secret         = "$WECOM_SECRET"
connection_type = "websocket"   # websocket (no public IP) or webhook

# Install beta build first
npm install -g cc-connect@beta

# Scan QR code to log in
cc-connect weixin setup

[project.mybot.platform]
type = "weixin"
# Auth state is stored after QR scan — no public IP needed

# Default config location: ~/.cc-connect/config.toml
cc-connect

# Custom config path
cc-connect --config /path/to/config.toml

# Run specific project only
cc-connect --project my-project

# Ask the agent to review a PR
Review the changes in branch feature/auth and summarize the risks.

# Switch to a different model
/model gemini-2.0-flash

# Change working directory
/dir /home/user/other-project

# Schedule a daily summary
/cron 0 6 * * * Summarize GitHub trending Go repos and post here

# Read agent memory
/memory

# Update agent memory
/memory Always prefer table-driven tests in Go. Use context.Context for cancellation.

# Bot 1: Claude
[project.claude-bot]
name     = "claude-bot"
work_dir = "/home/user/project"
data_dir = "/home/user/.cc-connect/data/claude"

[project.claude-bot.agent]
type = "claude-code"

[project.claude-bot.platform]
type  = "telegram"
token = "$TELEGRAM_CLAUDE_BOT_TOKEN"

# Bot 2: Gemini (same group)
[project.gemini-bot]
name     = "gemini-bot"
work_dir = "/home/user/project"
data_dir = "/home/user/.cc-connect/data/gemini"

[project.gemini-bot.agent]
type = "gemini"

[project.gemini-bot.platform]
type  = "telegram"
token = "$TELEGRAM_GEMINI_BOT_TOKEN"

[speech]
provider = "openai"           # openai | azure | google
api_key  = "$OPENAI_API_KEY"

[speech.stt]
model = "whisper-1"

[speech.tts]
model = "tts-1"
voice = "alloy"

# In config.toml, per-project cron settings
[project.mybot.cron]
timeout = "30m"          # max runtime per job
fresh_session = true     # start a new session for each run

# Every weekday at 9am, run a standup summary
/cron 0 9 * * 1-5 Summarize open PRs and blockers in this repo

# Every hour, check for new issues labeled "urgent"
/cron 0 * * * * Check for new GitHub issues labeled urgent and notify me

[project.mybot]
admin_from = "alice,123456789"   # comma-separated usernames or IDs

~/.cc-connect/
├── config.toml                          # main config
└── data/
    └── projects/
        └── my-project.state.json        # persisted dir override, session state

/cron 0 8 * * 1 Generate a weekly summary of commits and open issues, format as markdown

# Verify agent is installed and in PATH
which claude     # for claude-code
which gemini     # for gemini
which codex      # for codex

[project.mybot.agent]
type = "claude-code"
bin  = "/usr/local/bin/claude"

/session new

npm install -g cc-connect@beta
cc-connect weixin setup   # scan QR in terminal

[project.mybot.agent]
auto_compress        = true
compress_threshold   = 80000   # tokens before compression kicks in

cc-connect --config /custom/path/config.toml

cc-connect --version