프로젝트 소개

hcom은 서로 다른 터미널에서 실행되는 AI 코딩 에이전트들을 연결하여 통신하고, 서로를 모니터링하며, 하위 에이전트를 생성하거나 관리할 수 있게 해주는 명령줄 도구입니다. 에이전트 실행을 감싸는 방식(예: `hcom claude`, `hcom codex`)으로 작동하며, 활동을 로컬 SQLite 데이터베이스에 기록합니다. 에이전트는 이 데이터베이스를 조회하여 메시지를 보내고, 상태와 트랜스크립트를 관찰하며, 이벤트에 반응할 수 있습니다. 주요 기능은 다음과 같습니다: - 유휴 시 깨우기(wake-on-idle)를 지원하는 에이전트 간 실시간 메시징. - 에이전트 상태, 트랜스크립트, 파일 편집, 실시간 터미널 화면, 명령 기록 관찰. - 상태 변경, 파일 편집, 충돌, 사용자 정의 트리거에 대한 이벤트 구독. - 다양한 터미널 에뮬레이터 또는 헤드리스 모드에서 에이전트 생성, 포크, 재개, 종료. - 종단 간 암호화(XChaCha20-Poly1305)와 공유 사전 공유 키를 사용하는 MQTT 릴레이를 통한 크로스 디바이스 조정. - 에이전트 관리를 위한 TUI 대시보드(`hcom`). - 번들로 제공되는 워크플로 스크립트(예: debate, confess, fatcow, onidle)와 사용자 정의 스크립트 지원. - `~/.hcom/config.toml`을 통한 구성과 에이전트별 재정의 및 환경 변수 지원. 지원하는 AI 도구로는 Claude Code, Gemini CLI, Codex CLI, Antigravity CLI, OpenCode, Kilo Code, Pi, Oh My Pi, Cursor CLI, Kimi, Copilot CLI, Grok Build가 있습니다. 다른 도구는 `hcom start`와 `hcom listen`을 통해 참여할 수 있습니다. 이 프로젝트는 Rust로 작성되었으며 MIT 라이선스로 배포됩니다. 설치 방법으로는 `uv tool install hcom`, Homebrew, 셸/PowerShell 설치 프로그램이 있습니다.