aannoo/hcom

hcom – 将你的编程代理连接在一起

它是什么

• hcom 是一款命令行工具，可让你并排运行多个 AI 驱动的编程助手（Claude、Gemini、Codex、Copilot 等），并让它们彼此对话。
• 每个助手都作为普通终端进程启动，但当加上 hcom 前缀时，该工具会注入 hooks，将活动记录到本地 SQLite 数据库，并在代理之间转发消息。

为什么你可能会关心

• 如果你经常串联多个基于 LLM 的代码工具（例如让 Claude 编写一个函数，再让 Codex 审查），hcom 会自动完成交接，让你不必手动复制粘贴输出。
• 它提供一个微型仪表板（TUI），你可以在其中观看每个代理的实时记录、文件编辑和终端屏幕。
• 支持通过 MQTT 中继在不同机器上生成、分叉、终止或移动代理，因此适用于分布式或多设备工作流。

主要功能（来自 README）

功能	作用
实时消息传递	代理可以在回合中或空闲时互相发送消息。
观察	你可以查看任意代理的状态、记录、文件变更和实时终端输出。
事件订阅	脚本可以自动响应事件，例如文件编辑或代理进入空闲状态。
生成 / 分叉 / 终止	可在任意终端模拟器（kitty、wezterm、tmux 等）或无头 PTY 中启动任意数量的代理。
跨设备中继	使用令牌通过 MQTT 中继连接不同机器上的代理。
CLI 与 TUI	hcom 命令提供许多子命令（send、list、events、run……），以及只需运行 hcom 即可打开的仪表板。
可配置	设置位于 ~/.hcom/config.toml；你可以设置默认值、按代理覆盖，甚至按项目隔离状态。
工作流脚本	内置脚本（debate、confess、fatcow、onidle）以及用于自定义多代理模式的简单插件系统。

典型工作流

1. 打开两个终端。

   hcom claude   # launches Claude in a terminal window
   hcom codex    # launches Codex in another window
   

2. 在任一窗口中输入提示，例如 “问另一个代理最喜欢的蛋糕是什么”。
3. 代理现在可以交换消息、生成子代理，或等待彼此进入空闲状态，全部由 hcom 编排。
4. 使用 hcom 打开仪表板，在一个地方监控一切。

安装

• 通过以 Python 为中心的 uv 工具：uv tool install hcom（跨平台）。
• Homebrew formula：brew install aannoo/hcom/hcom。
• 适用于 macOS/Linux（curl … | sh）或 Windows PowerShell 的直接安装脚本。

支持的 AI 工具（自动集成）

• Claude、Gemini、Codex、OpenCode、Kilo、Pi、Oh My Pi、Cursor、Kimi、Copilot、Qoder、Grok、Antigravity，以及任何其他可用 hcom start 包装的 CLI。

适用场景

• 构建由一个 LLM 生成代码、另一个 LLM 审查或测试的流水线。
• 运行长时间在后台运行、需要在空闲时被提醒的代理。
• 协调多个终端或远程机器上的许多小型 AI 助手。

许可证

• MIT，因此你可以自由修改和再分发。

---

以上所有细节均直接取自该仓库的 README。