hcom

hcom 是一个以 Rust 编写的终端级多 Agent 协作工具，定位为编码 Agent 之间的通信与编排中间层。它不替代任何 AI Agent，而是通过自动注入的 hooks 将 Claude Code、Gemini CLI、Codex、OpenCode 等编码 Agent 接入统一的 SQLite 消息总线，实现跨终端的实时消息传递、上下文交接与事件订阅。

在协作能力方面，hcom 支持 Agent 间互相查看转录记录、文件编辑内容、终端屏幕与命令历史；内置碰撞检测机制，当两个 Agent 在 30 秒内编辑同一文件时会自动发出告警；同时提供完整的生命周期管理能力，可跨终端生成、分叉、恢复或终止 Agent。消息投递针对主流编码 Agent 做了适配——在工具调用间隙（mid-turn）注入消息，或对空闲 Agent 立即唤醒。

在分布式场景下，hcom 基于 MQTT 协议提供 relay 功能，支持通过 token 认证在不同机器间建立 Agent 网络。项目以 MIT 协议开源，通过 Homebrew 和 PyPI 分发，当前处于 Beta 阶段（v0.7.13），适用于 macOS 与 Linux 平台。仓库内还包含 Claude Code 插件和 Gemini CLI 扩展定义，降低接入门槛。

安装方式

# Homebrew（推荐）
brew install aannoo/hcom/hcom
# PyPI
pip install hcom

快速开始

# 终端 1
hcom claude
# 终端 2
hcom codex
# 打开 TUI 管理界面
hcom

核心 CLI 命令

• hcom <agent_name>：前缀方式启动 Agent（如 claude、codex、gemini、opencode）
• hcom：打开 TUI 管理界面
• hcom start：将其他 AI 工具加入 hcom 网络
• hcom send：从任意进程向 Agent 发送消息
• hcom status：输出诊断信息
• hcom reset all：清除并归档数据库、hooks、配置
• hcom hooks remove：安全移除所有 hcom hooks
• hcom config terminal --info：查看自定义终端配置信息
• hcom run docs：告知 Agent 运行文档
• hcom relay new / hcom relay connect <token> / hcom relay status / hcom relay on|off：跨设备 relay 管理

环境变量

• HCOM_DIR：自定义 hooks 和配置目录（默认在 ~/ 下）

架构要点

• 消息机制：agent → hooks → db (SQLite) → hooks → other agent
• Hooks 在首次运行时自动安装，不使用 hcom 时无任何副作用
• 跨设备通信基于 MQTT 协议
• 仓库包含 .claude-plugin、plugin/hcom、skills/hcom-agent-messaging、gemini-extension.json 等插件与扩展定义