botmux – Feishu에서 AI 코딩 CLI를 원격 제어

개요

• Node.js가 필요 없는 자체 포함 바이너리로, Feishu(Lark) 메시지를 수신하는 데몬을 실행합니다.
• 각 새 채팅 세션에 대해 독립적인 CLI/에이전트 프로세스(예: Claude-Code, Codex, Gemini 등)를 생성하고 프로세스 출력을 실시간 업데이트 카드로 채팅에 스트리밍합니다.
• 브라우저나 휴대폰에서 CLI에 직접 입력할 수 있는 대화형 웹 터미널을 제공합니다.

중요성

• 개발자는 강력한 AI 코딩 에이전트를 로컬에서 실행하지만 모바일 기기에서 모니터링하거나 제어할 방법이 없습니다. botmux는 이 격차를 해소합니다: Feishu에서 메시지 하나로 세션이 시작되고 에이전트 출력이 즉시 카드로 표시되며 웹 터미널을 통해 대화를 계속하거나 중단하거나 인계받을 수 있습니다.
• 인기 있는 AI 코딩 CLI 및 원격 에이전트용 20개 이상의 어댑터를 지원하므로 에이전트 로직을 다시 작성하거나 재구현할 필요가 없습니다. botmux는 단순히 stdin/stdout을 전달합니다.

주요 기능(README 설명 기반)

기능	제공 내용
원클릭 세션 시작	Feishu 그룹에서 @bot <프롬프트>를 보내면 새 CLI 프로세스가 생성됩니다. 각 세션은 격리됩니다.
실시간 스트리밍 카드	출력의 각 줄은 새로 고침된 카드로 전송되며 숨기기/표시, 스크롤, 재시작, 세션 종료 컨트롤이 있습니다.
멀티봇 협업	여러 봇이 같은 그룹에 있을 수 있습니다. @bot-name은 요청을 선택한 CLI/에이전트(예: Claude-Code vs Codex)로 라우팅합니다.
웹 터미널	브라우저 기반 터미널(모바일 친화적)로 실행 중인 프로세스에 직접 입력, Ctrl-C 전송, 탐색 등을 할 수 있습니다.
세션 인계	/adopt 같은 명령으로 다른 사용자가 실행 중인 tmux 세션을 인계받을 수 있습니다. /relay는 전체 세션을 다른 그룹으로 이동합니다.
스케줄링 및 웹훅	자연어 명령으로 주기적 작업을 생성합니다. 외부 시스템은 웹훅이나 API로 실행을 트리거할 수 있습니다.
온콜 모드 및 음성 요약	온콜 그룹에서 누구나 @ 봇으로 진단을 실행할 수 있습니다. 선택적 TTS로 오디오 요약 버튼을 추가할 수 있습니다.
제로 인젝션 모드	botmux가 추가하는 프롬프트를 억제하여 CLI가 원래 사용자 메시지만 볼 수 있게 합니다. "리드 봇" 워크플로에 유용합니다.
피드백 수집	최종 답변 카드에 구성 가능한 좋아요/진행/싫어요 버튼을 포함하고 로컬에 저장할 수 있습니다.
크로스 플랫폼 설치	단일 바이너리로 Linux/macOS(x64 및 arm64) 및 WSL2를 통한 Windows에서 작동합니다. npm install -g botmux로도 설치할 수 있습니다(npm 패키지는 동일한 바이너리를 제공).
확장 가능한 어댑터	bots.json은 실행할 CLI, 작업 디렉터리, 환경 변수, 샌드박싱 등을 정의합니다. 어댑터는 로컬 CLI, 클라우드 에이전트(Mira, riff), 일반 원격 러너 프로토콜을 포함합니다.

일반적인 워크플로

1. 한 줄 curl … | sh(또는 npm)로 바이너리를 설치합니다.
2. botmux setup 실행 – QR 코드를 스캔하여 Feishu 앱을 만들고 노출할 CLI를 선택하고 작업 디렉터리를 설정합니다.
3. 데몬 시작: botmux start(또는 자동 시작 활성화).
4. Feishu 채팅에서 @bot <프롬프트>를 보내면 세션이 시작되고 봇은 CLI 출력에 따라 업데이트되는 카드로 응답합니다.
5. 카드의 웹 터미널 링크를 사용하여 직접 상호 작용하거나 /adopt, /relay, /cli <id> 등의 명령으로 세션을 관리합니다.

대상 사용자

• 로컬에서 AI 코딩 어시스턴트를 사용하고 모바일/원격 가시성을 원하는 개발자.
• 같은 채팅에서 여러 에이전트를 사용해야 하는 팀(예: Claude-Code 및 Codex로 코드 리뷰).
• AI 기반 진단을 예약하거나 웹훅으로 노출하려는 운영 팀.

라이선스 및 커뮤니티

• MIT 라이선스로 오픈소스.
• 전체 문서는 https://deepcoldy.github.io/botmux/에 있으며 지원 커뮤니티 채팅이 있습니다.

---

위의 모든 세부 사항은 저장소의 README에서 직접 가져온 것이며 추가 기능은 추론되지 않았습니다.