CCGram v4: Control AI Coding Agents from Telegram — Now with herdr Support

개요

CCGram v4.0.0은 Telegram을 통해 AI 코딩 에이전트를 제어하는 인터페이스로, 새로운 herdr 터미널 멀티플렉서 백엔드 지원을 추가했습니다.

주요 내용

• CCGram의 기본 기능: Telegram 포럼 토픽이 터미널 멀티플렉서 창과 1:1로 연결되어, 사용자는 전화기로 에이전트 출력 모니터링, 프롬프트 응답, 세션 관리가 가능합니다. 에이전트 프로세스는 로컬 머신에서 실행되며, 자리를 비워도 Telegram으로 계속 작업할 수 있습니다.
• herdr 백엔드 지원: CCGram v4.0.0은 herdr 터미널 멀티플렉서를 지원합니다. herdr은 기존 tmux와 유사하지만, 세션 및 창 기반이 아닌 이름이 지정된 워크스페이스와 탭 중심으로 구성된 현대적인 멀티플렉서입니다.
• herdr 사용 시 변경점:
• 적응형 토픽 레이블: herdr에서는 토픽이 "워크스페이스 ▸ 탭" 형식으로 레이블링됩니다 (예: "api ▸ auth-rewrite").
• 새 세션 시 워크스페이스 피커: /new 명령으로 새 세션을 생성할 때, 기존 워크스페이스에 새 탭을 고정할 수 있는 워크스페이스 피커 단계가 추가됩니다.
• 에이전트 탭만 토픽으로 표시: herdr에서는 Claude Code, Codex, Gemini, Pi와 같이 에이전트 CLI를 실행하는 탭만 Telegram 토픽으로 표시됩니다. 일반 쉘 탭은 표시되지 않습니다.
• 네이티브 에이전트 상태: herdr은 자체 Pane process-info 기능을 통해 실행 중인 프로세스를 직접 보고하므로, CCGram은 터미널 출력을 스크랩할 필요 없이 에이전트 상태를 파악할 수 있습니다.
• 세션 재해상도: herdr 서버 재시작 시 탭 ID가 변경되더라도, Claude hook에서 기록한 공유 세션 ID를 통해 CCGram이 stale 탭 ID를 새 ID로 다시 매핑하여 Telegram 토픽 바인딩이 유지됩니다.
• 프로토콜 버전 고정: CCGram은 빌드된 herdr 소켓 프로토콜 버전을 고정하고, 버전 불일치 시 시작을 거부합니다.
• Claude Code 훅: 세션 추적 및 이벤트 발생 훅은 herdr에서는 $HERDR_PANE_ID, tmux에서는 $TMUX_PANE을 사용하여 어떤 창에서 발생했는지 식별합니다.
• 아키텍처: 멀티플렉서 접근은 multiplexer/base.py의 Multiplexer Protocol 뒤에 숨겨져 있으며, tmux 및 herdr은 동일한 프로토콜을 구현하여 WindowRef, PaneInfo, CaptureResult, ForegroundInfo와 같은 중립적인 값 타입을 반환합니다.
• herdr 시작 방법: CCGRAM_MULTIPLEXER=herdr 환경 변수를 설정하고 CCGram을 실행하면 됩니다.

시사점

herdr 백엔드 지원 추가는 CCGram이 더 현대적이고 체계적인 워크스페이스/탭 관리 기능을 제공하며, 에이전트 상태 파악을 위한 네이티브 기능을 활용하여 보다 효율적인 AI 코딩 에이전트 제어 경험을 제공합니다.