cc-connect Manager

Manage cc-connect projects by editing ~/.cc-connect/config.toml and restarting the service in tmux.

Config file

Path: INLINECODE1

Add a project

Extract these from the user's request:

• - name: project name (derive from workdir basename if not given, e.g. /path/to/my-app → my-app)
• workdir: absolute path to the project directory
• platform: one of telegram, discord, feishu, dingtalk, slack, line, wecom, qq, INLINECODE12
• token: the bot token (varies by platform)
• agent: default claudecode, or codex, cursor, gemini, qoder, opencode, INLINECODE19
• mode: default default. For claudecode: acceptEdits/plan/bypassPermissions. For codex: suggest/auto-edit/full-auto/INLINECODE27

Run the add script:

CODEBLOCK0

Platform-specific token mapping:

• - telegram: --token = bot token from @BotFather
• discord: --token = bot token, optionally --guild-id for instant slash commands
• feishu: --app-id + INLINECODE32
• dingtalk: --app-id + INLINECODE34
• slack: --bot-token (xoxb-) + --app-token (xapp-)

After adding, read back ~/.cc-connect/config.toml and show the user the new project block for confirmation.

Multi-agent relay setup (bind)

To put multiple agents (e.g. Claude Code + Codex) in the same chat group:

Architecture

• - Each agent needs its own bot (separate token) as a separate [[projects]] entry
• All bots join the same group/channel/server
• After startup, use /bind in the chat to link them for relay communication

Step-by-step

1. 1. Add project A (e.g. claude-backend, agent=claudecode, platform=discord, token=bot-A-token)
2. Add project B (e.g. codex-backend, agent=codex, platform=discord, token=bot-B-token)
3. Both bots must use the same platform type and join the same group/channel
4. Restart cc-connect
5. Tell the user to send these commands in the chat group (not here):

   @bot-A /bind claude-backend
   @bot-A /bind codex-backend
   

1. 6. After binding, agents can relay messages to each other. @bot-A sends to Claude Code, @bot-B sends to Codex

Important notes

• - /bind is a runtime chat command, not a config file setting — it cannot be automated from here
• Binding persists in INLINECODE44
• Each bot in the group needs a unique token (you cannot reuse the same bot for two projects)

Remove a project

Read ~/.cc-connect/config.toml, find the [[projects]] block with matching name, remove it and all its sub-sections ([projects.agent], [projects.agent.options], [[projects.platforms]], [projects.platforms.options]) up to the next [[projects]] or global section. Write the file back.

Restart cc-connect

cc-connect runs in a tmux session named cc-connect. To restart:

CODEBLOCK2

If the tmux session doesn't exist yet:

CODEBLOCK3

Always restart after adding or removing a project.

Workflow

1. 1. Parse the user's natural language request to extract project params
2. Run add_project.py for each project (or manually edit for removal)
3. Show the user the updated config block
4. Restart cc-connect in tmux
5. Confirm success by checking tmux output: INLINECODE54
6. If multi-agent setup, remind the user to run /bind <project-name> for each project in the chat group