UNLINEARITY/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 切换、文件传输、审批交互与运行状态同步。

CLI WeChat Bridge – 概要

CLI WeChat Bridgeは、WeChatまたは企業用WeChatをリモートの入り口として使用しながら、ローカルのAIコーディングアシスタント（OpenAI Codex、Anthropic Claude Code、OpenCode、Pi）を使い続けることができるNode-JSコマンドラインツールです。PC上でブリッジを実行し、WeChatにログイン（または企業用WeChatボットを設定）することで、チャットアプリからプロンプト、ファイル、制御コマンドを送信できます。ブリッジはこれらのメッセージを選択したローカルCLIに転送し、出力をキャプチャして、返信（またはステータス更新）をチャットの会話に送り返します。

このプロジェクトは、ネイティブなターミナル体験の維持に重点を置いています。AIモデルは元のCLIで実行され、そのすべてのフラグや対話機能が保持されます。WeChatは単なる軽量なリモートUIとして機能します。

想定されるユーザー

すでにCodex、Claude Code、OpenCode、Piをコマンドラインインターフェース経由で利用している開発者。
Web UIに切り替えることなく、スマートフォンや他のデバイスからこれらのツールを操作したい方。
企業用WeChatボットを社内自動化に使用しており、既存のローカルAIワークフローに組み込みたいチーム。

主な機能 (READMEより)

機能	内容
複数のAI-CLIツールへのブリッジ	Codex、Claude Code、OpenCode、Piをサポート。ブリッジがネイティブCLIを起動または再利用し、プロンプトを転送します。
2つのリモートチャンネル	個人用WeChat (`wechat-setup`, `wechat-` コマンド) および企業用WeChat (`wecom-setup`, `wecom-` コマンド)。
デーモンモード	`wechat-daemon` / `wecom-daemon` により接続を維持し、4つのAIツールを即座に切り替え、単一の作業ディレクトリを管理できます。
単一コマンドのショートカット	`wechat-codex`, `wechat-claude`, `wechat-opencode`, `wechat-pi` (および対応する `wecom-` コマンド) でCLIを直接起動。
ファイル転送	WeChatから送信された画像や汎用ファイルはローカルに保存され、ファイルパスがプロンプトに付加されるため、AIモデルが読み取れます。
豊富なリモートコマンド	`/codex`, `/claude`, `/opencode`, `/pi` でツール切り替え。`/status`, `/model`, `/plan`, `/stop`, `/reset`, `/new`, `/resume`, `/confirm`, `/deny`, `/daemon-stop` など。
絵文字バインディング	メッセージの先頭にある特定の絵文字をコマンドにバインド可能 (例: ✅ → `/confirm`)。
コンテキストトークンの処理	ブリッジが `context_token` を保持し、返信が元のチャットに正しくルーティングされるようにします。
クロスプラットフォーム対応	Windows, macOS, Linuxで動作。必要に応じて `node-pty` を使用してPTYエミュレーションを行います。
インストールと更新	npm経由で配布 (`cli-wechat-bridge` またはスコープ付き `@unlinearity/cli-wechat-bridge`)。
トラブルシューティング	`wechat-daemon --doctor`、PTYの問題、プロキシ設定、トークン制限などに関する詳細なドキュメント。

仕組み – 高レベルアーキテクチャ

ログイン / ペアリング – wechat-setup (QRコードログイン) または wecom-setup (ボットID + Secret) を実行して、ローカルに保存される認証情報を取得します。
ブリッジプロセス – Node.jsランタイムがWeChat/企業用WeChatチャンネルの着信メッセージを監視します。
アダプター層 – サポートされている各AIツールには、CLIの起動方法 (PTYまたはWebSocket RPC経由) とプロンプトの入力方法を知っている アダプター が存在します。
メッセージフロー
- チャットメッセージ → ブリッジ → 適切なアダプター → ローカルCLI。
- CLI出力 (最終回答、ステータス更新、承認リクエストを含む) → ブリッジ → チャット。
デーモン – wechat-daemon を起動すると、ブリッジが常駐し、作業ディレクトリをロックし、プロセス全体を再起動することなくアダプターを切り替えることができます。
IPC – デーモンはトークン保護されたローカルIPCエンドポイントを公開し、他のプログラム (カスタムWebパネルなど) が同じブリッジにテキストを送信できるようにします。

はじめ方 (クイックステップ)

前提条件 – Node ≥ 22.13。また、いずれかのAI CLIがインストールされ、PATH からアクセス可能であること。
インストール – npm install -g cli-wechat-bridge。
ログイン – wechat-setup (QRコードスキャン) または wecom-setup (ボットID/Secret入力)。
テストメッセージの送信 – WeChatから (例: hello)。これにより context_token が初期化されます。
CLIの実行 – プロジェクトフォルダ内で wechat-codex (または他のショートカット) を実行するか、wechat-daemon で常駐デーモンを開始します。
制御 – 上記のスラッシュコマンドを使用して、ツールの切り替え、実行の停止、モデルの変更などを行います。

メンテナンスについて

このリポジトリは UNLINEARITY (GitHubユーザー/組織) が所有しています。READMEには製品ホームページ、CIバッジ、詳細なドキュメントセットへのリンクがあり、活発にメンテナンスされているオープンソースプロジェクトであることが示されています。

ライセンス

デュアルライセンス：オープンソース利用には AGPL-3.0-or-later、クローズドソース展開には商用ライセンスオプションが提供されます。

結論： CLI WeChat Bridgeは、ローカルのAIコーディングCLIをWeChat/企業用WeChatに接続する実用的なツールであり、モバイルチャットクライアントからコマンドを発行しながら、好みのターミナルワークフローを維持できます。