cakcode/connect2cli-bridge

A pure Python conversation bridge service between WeCom’s intelligent robot and the codex CLI, with default docking to codex and also supporting compatible claude backend.

English overview: README.en.md

If you want to give others a simple process of “just providing botId, secret, GitHub addresses, Codex can help deploy,” look at it directly: README.codex-deploy.md

The main positioning of this project is not a general chatbot for public networks, but rather a multi-person workspace bridging layer for group collaboration:

• Each member has their own independent session workspace and file directory
• When multiple people on the same bot simultaneously pull code, modify files, or run commands, they do not affect each other
• Using WeCom’s entry point, turn codex into a reusable collaborative development tool within the group

This is a front-less headless service responsible for:

• Maintain long-term connections on WeCom WebSocket
• Manage multi-bot configuration and persistence
• Optional agent backend (codex / claude) for sessions, and attempts a native resume when the current runtime can be restored
• Provides an isolated workspace for multi-group collaboration, ensuring that each person’s file and code operations do not affect each other
• Provides layered injection and isolation between globally shared skills and personal private skills
• Provides session control commands /bridge-status, /bridge-interrupt, /bridge-reset, [T11]], [T12]], [T13]], [T14]], /cwd
• Download WeChat images/files to your local workspace
• Externally expose running status and the latest summaries, facilitating frontend polling and refreshing
• Supports segmented replies and follow-up transfers after 10 minutes of WeChat for ultra-long running sessions
• Send files back to Qweo via local commands or API
• Supports one-time scheduled messages and cron periodic scheduling
• Exposing Bot / Session / Schedule JSON API

The default listening address is http://127.0.0.1:9299. The root path / only returns JSON status and does not provide a web UI.

Get Started Quickly

1. Prerequisites

• Installed python3
• Installed and can be run directly codex
• bridge Run: The user has already executed codex login
• Obtained WeCom’s intelligent robot botId
• Prepared readable secret files

Recommended: First:

2. Installation dependency

If you need to run tests:

3. Ready to configure

First, copy the template:

A minimum startable example:

Explanation:

• Choose either BRIDGE_BASIC_AUTH or BRIDGE_TOKEN; If neither is suitable, /healthz and /api/* only allow localhost access