UNLINEARITY/CLI-WeChat-Bridge

해결하는 문제

이 프로젝트는 로컬 터미널에서 실행되는 AI 코딩 보조 도구에 원격으로 접근할 수 있도록 합니다. 로컬 개발 환경과 WeChat 사이의 격차를 메우며, 사용자가 로컬 AI 도구에 요청을 보내고, 출력 결과, 상태 업데이트, 승인 요청(승인/거부)을 웹 인터페이스나 호스팅된 봇으로 이전하지 않고도 모바일 기기에서 수신할 수 있도록 합니다.

작동 방식

이 도구는 WeChat 메시징 플랫폼과 여러 로컬 CLI 기반 AI 에이전트 사이를 연결하는 다리 역할을 합니다. Codex, Claude Code, OpenCode, Pi에 대한 연결을 지원합니다. 시스템은 로컬 터미널을 주 인터페이스로 유지하면서 WeChat은 원격 입력/출력 채널로 사용합니다. node-pty를 사용하여 터미널 에뮬레이션을 수행하며, 장기간 연결을 유지하고 다양한 AI 어댑터 간 전환을 가능하게 하는 데몬 모드를 지원합니다.

대상 사용자

주된 워크플로우로 네이티브 CLI 도구(예: Claude Code 또는 Codex)를 선호하지만, 컴퓨터에서 떨어져 있을 때도 WeChat을 통해 명령을 전송하고 AI 에이전트의 진행 상황을 모니터링하고 싶은 개발자.

주요 기능

• 다중 에이전트 지원: Codex, Claude Code, OpenCode, Pi에 연결 가능.
• 원격 승인: WeChat에서 직접 CLI 승인 요청(승인/거부)을 처리할 수 있음.
• 데몬 모드: 지속적인 연결을 유지하고 WeChat 명령(예: /claude, /codex)을 사용해 다양한 AI 도구 간 전환 가능.
• 이모지 바인딩: /confirm 또는 /stop과 같은 일반 명령어에 특정 WeChat 이모지를 매핑하여 더 빠른 상호작용 가능.
• 파일 전송: WeChat에서 로컬 CLI로 파일을 전송하여 AI가 분석할 수 있도록 하며, 반대로 로컬 파일을 WeChat으로 전송 가능.
• 워크스페이스 격리: 현재 디렉터리를 워크스페이스로 사용하여 서로 다른 프로젝트 디렉터리가 분리되어 유지됨.