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 명령줄 도구입니다. 컴퓨터에서 브리지를 실행하고 WeChat에 로그인(또는 기업용 WeChat 봇 설정)하면 채팅 앱에서 프롬프트, 파일, 제어 명령을 보낼 수 있습니다. 브리지는 이러한 메시지를 선택한 로컬 CLI로 전달하고 출력을 캡처하여 회신(또는 상태 업데이트)을 채팅 대화로 다시 보냅니다.

이 프로젝트는 네이티브 터미널 환경을 유지하는 데 중점을 두고 있습니다. AI 모델은 원래의 CLI에서 실행되며 모든 플래그와 대화형 기능을 유지하고, WeChat은 가벼운 원격 UI 역할만 수행합니다.

권장 사용자

이미 Codex, Claude Code, OpenCode 또는 Pi를 명령줄 인터페이스를 통해 사용 중인 개발자.
웹 UI로 전환하지 않고 휴대폰이나 다른 기기에서 이러한 도구를 실행하고 싶은 분.
기업용 WeChat 봇을 내부 자동화에 사용 중이며 기존 로컬 AI 워크플로우에 연결하려는 팀.

핵심 기능 (README 설명 기준)

기능	설명
다양한 AI-CLI 도구 연결	Codex, Claude Code, OpenCode 및 Pi 지원. 브리지가 네이티브 CLI를 시작하거나 재사용하여 프롬프트를 전달합니다.
두 가지 원격 채널	개인용 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` 또는 scoped `@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 엔드포인트를 노출하여 다른 프로그램(예: 사용자 지정 웹 패널)이 동일한 브리지로 텍스트를 보낼 수 있게 합니다.

시작하기 (빠른 단계)

사전 요구 사항 – 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 코딩 명령줄 인터페이스를 WeChat/기업용 WeChat에 연결하는 실용적인 도구로, 모바일 채팅 클라이언트에서 명령을 내리면서도 선호하는 터미널 워크플로우를 유지할 수 있게 해줍니다.