CLI-WeChat-Bridge

Bridge WeChat, WeCom & Telegram to local Codex, Claude Code, OpenCode & Pi. Keep the native terminal experience & CLI options with bidirectional interaction, mu

What is CLI-WeChat-Bridge?

Bridge WeChat, WeCom & Telegram to local Codex, Claude Code, OpenCode & Pi. Keep the native terminal experience & CLI options with bidirectional interaction, multi-session bridging, CLI switching, file transfer, approvals & status sync. 微信、企业微信与 Telegram 接入本地 Codex、Claude Code、OpenCode 和 Pi,保留原生终端体验与高级启动参数,支持原生双向交互、多会话桥接、多 CLI 切换、文件传输、审批交互与运行状态同步。

Overview of CLI-WeChat-Bridge

What it is

CLI-WeChat-Bridge is a tool that bridges WeChat, WeCom (WeChat Work), and Telegram messages to locally running CLI tools such as Codex, Claude Code, OpenCode, and Pi. It keeps the native terminal experience and CLI options while enabling bidirectional interaction, multi-session bridging, CLI switching, file transfer, approval interactions, and status synchronization. The project is designed around local workflows, with WeChat, WeCom, or Telegram acting as remote input channels while the local CLI remains the primary interface.

Key features

  • Bridges WeChat, WeCom, and Telegram to local Codex, Claude Code, OpenCode, and Pi - Preserves native terminal experience and advanced CLI startup parameters - Supports bidirectional interaction, multi-session bridging, and multi-CLI switching - Enables file transfer, approval interactions, and runtime status sync - Implements a progressive bridging mode (L0 single bridge, L1 multi-CLI, L2 multi-instance of same type, L3 multi-directory)
  • Uses node-pty for full terminal emulation (with fallback for Claude Code)
  • Provides separate setup commands for each channel (wechat-setup, wecom-setup, telegram-setup)

Use cases

This project is suitable for users whose primary workflow remains in a local terminal, who want to continue using native CLIs like Codex, Claude Code, OpenCode, or Pi instead of migrating to web or hosted bots, and who need to send requests to local sessions and receive output and status updates via WeChat, WeCom, or Telegram when away from their computer.

Getting started

Install globally via npm: bash npm install -g cli-chat-bridge@latest Or install the equivalent package: bash npm install -g cli-wechat-bridge@latest After installation, complete login for your chosen channel:

  • WeChat: run wechat-setup and scan the QR code - WeCom: run wecom-setup and enter Bot ID and Secret - Telegram: run telegram-setup and enter Bot Token, then pair with /pair Then navigate to your project directory and start a bridge command, for example: bash cd /path/to/your-project wechat-codex See the repository README for full details on environment requirements, troubleshooting, and all available commands.

License and pricing

Licensed under AGPL-3.0. Open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/unlinearitycli-wechat-bridge.svg)](https://yunodb.com/tools/unlinearitycli-wechat-bridge?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/unlinearitycli-wechat-bridge?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/unlinearitycli-wechat-bridge.svg" alt="Featured on YunoDB" height="20"></a>