Summary

CLI WeChat Bridge integrates AI command-line tools (Codex, Claude Code, OpenCode) with WeChat, enabling remote interaction with local development workflows. It targets developers who prefer their native terminal but need WeChat for asynchronous requests and status updates, preserving local CLI experience while offering remote access.

How It Works

This project bridges WeChat messages with local AI CLI processes, synchronizing terminal threads and sessions bidirectionally. It prioritizes the local terminal as the primary interface, using WeChat as a remote entry point for input, output, and status synchronization. A daemon mode supports persistent connections and multi-CLI switching, while single-start modes launch specific CLI bridges. The approach retains native CLI functionality and advanced parameters, integrating them seamlessly with WeChat for asynchronous, remote development tasks.

Quick Start & Requirements

• Installation: npm install -g cli-wechat-bridge@latest
• Prerequisites: Node.js >= 24.0.0 (LTS recommended), and installed Codex, Claude Code, or OpenCode CLIs.
• Setup: Run wechat-setup for WeChat login. Crucially, send an initial message from WeChat to the bot after starting the bridge to establish context.
• Running: Use single-command starters like wechat-codex-start or wechat-daemon for persistent connections and multi-CLI switching via WeChat commands (/codex, /claude).

Highlighted Details

• Enables bidirectional local file transfer and preserves native CLI experience with advanced parameters.
• Offers a persistent wechat-daemon for seamless switching between Codex, Claude Code, and OpenCode from WeChat.
• Supports thread/session sharing, bidirectional conversations, and WeChat emoji bindings for quick command execution.

Maintenance & Community

The project acknowledges contributors and feedback providers. Specific community links (Discord/Slack), roadmaps, or sponsorship details are not detailed in the README. Key dependencies include @opencode-ai/sdk and node-pty.

Licensing & Compatibility

The project is dual-licensed under AGPL-3.0. This open-source license requires derivative works and network-provided services to be open-sourced under the same terms. Commercial use in closed-source products necessitates obtaining a separate commercial license from the author.

Limitations & Caveats

The bridge does not perform OCR on images or extract text from PDFs/DOCX; local CLIs must handle file parsing. Establishing WeChat context with an initial message is vital for stable synchronization. The AGPL-3.0 license's strong copyleft provisions may pose adoption challenges for closed-source commercial products. The WeChat-side /resume command is currently disabled.