Back to Details

hcom-agent-messaging

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

hcom — multi-agent communication for AI coding tools

hcom — AI 编程工具的多 Agent 通信

AI agents running in separate terminals are isolated. hcom connects them via hooks and a shared database so they can message, watch, and spawn each other in real-time.
Start an agent with 
hcom
in front, then prompt normally.
Use hcom to:
  • coordinate multi-agent pipelines
  • run different AI CLIs as each other's subagents
  • avoid copy-pasting
bash
uv tool install hcom
hcom claude       # or: hcom gemini, hcom codex, hcom opencode, hcom kilo, hcom pi, hcom omp, hcom agy, hcom cursor, hcom kimi, hcom copilot, hcom qoder, hcom grok, hcom hermes
hcom              # TUI dashboard
Quickstart:
bash
undefined
在不同终端中运行的 AI Agent 彼此隔离。hcom 通过 hooks 和共享数据库将它们连接起来，使它们能够实时地互相发送消息、观察彼此并生成新的 Agent。
启动 Agent 时，在命令前加上 
hcom
，然后照常输入提示词。
使用 hcom 可以：
  • 协调多 Agent 流水线
  • 将不同的 AI CLI 作为彼此的子 Agent 运行
  • 避免复制粘贴
bash
uv tool install hcom
hcom claude       # or: hcom gemini, hcom codex, hcom opencode, hcom kilo, hcom pi, hcom omp, hcom agy, hcom cursor, hcom kimi, hcom copilot, hcom qoder, hcom grok, hcom hermes
hcom              # TUI dashboard
快速入门：
bash
undefined

terminal 1

terminal 1

hcom claude
hcom claude

terminal 2

terminal 2

hcom codex

Prompt normally — e.g. `review what claude did and send it fixes`

---
hcom codex

照常输入提示词——例如：`review what claude did and send it fixes`

---

what humans can do

人类可以做什么

tell any agent:
send a message to claude
when codex goes idle send it the next task
watch gemini's file edits, review each and send feedback if any bugs
fork yourself to investigate the bug and report back
find which agent worked on terminal_id code, resume them and ask why it sucks
告诉任意 Agent：
向 claude 发送消息
当 codex 空闲时，向它发送下一个任务
观察 gemini 的文件编辑，逐项审查，并在发现任何 bug 时发送反馈
生成自身的副本以调查该 bug 并汇报结果
找出处理 terminal_id code 的 Agent，恢复该 Agent，并询问它为什么做得这么差

what agents can do

Agent 可以做什么

Message each other in real time: mid-turn or wake immediately when idle
Observe each other: status, transcripts, file edits, live terminal screens, command history.
Subscribe and notify on status changes, file edits, collisions, specific events. React automatically.
Spawn, fork, resume, kill in any terminal emulator or headless.
run 
hcom --help
for full command syntax and flags.
Works with Claude Code, Gemini CLI, Codex, OpenCode, Kilo Code, Pi, Oh My Pi, Antigravity, Cursor, Kimi, Copilot, Qoder CLI, Grok Build, Hermes Agent, and other tools
Message：实时地互相发送消息；可在执行过程中发送消息，也可在对方空闲时立即将其唤醒
Observe：观察彼此的状态、转录记录、文件编辑、实时终端画面和命令历史。
Subscribe：订阅状态变化、文件编辑、冲突和特定事件，并在发生时收到通知。自动作出响应。
Spawn、Fork、Resume、Kill：在任意终端模拟器或无头环境中操作 Agent。
运行 
hcom --help
查看完整的命令语法和 flags。
适用于 Claude Code、Gemini CLI、Codex、OpenCode、Kilo Code、Pi、Oh My Pi、Antigravity、Cursor、Kimi、Copilot、Qoder CLI、Grok Build、Hermes Agent 等工具

setup

配置

When this skill is invoked, first run:
bash
hcom status
If hcom status works: run 
hcom list
If hcom list shows "Your name: <name>" where 
<name>
is not "(not participating)": congratulations!
If running 
hcom status
returns "command not found", install first:
bash
uv tool install hcom
See the hcom README for other install options.
If hcom status shows a list of CLI tools and you are not any of them, run 
hcom start
to connect to hcom.
If you've just installed hcom now or if hcom list shows "Your name: (not participating)" and you are a tool in the hcom status list of CLI tools:
Relaunch into hcom properly for automatic message delivery and full hcom functionality. User should exit and run 
hcom <tool>
. Or if you know your sessionID/ses_/thread_name: user can exit and run 
hcom r <session-id>
to resume you inside hcom. See 
hcom r --help
.
调用此 skill 时，首先运行：
bash
hcom status
如果 hcom status 可以正常运行：运行 
hcom list
如果 hcom list 显示 "Your name: <name>"，其中 
<name>
不是 "(not participating)"，说明你已经成功加入！
如果运行 hcom status 时返回 "command not found"，请先安装：
bash
uv tool install hcom
有关其他安装方式，请参阅 hcom README。
如果 hcom status 显示了一个 CLI 工具列表，而你不在其中，请运行 
hcom start
连接到 hcom。
如果你刚刚安装了 hcom，或者 hcom list 显示 "Your name: (not participating)"，并且你是 hcom status 所列 CLI 工具中的一种：
请正确地重新在 hcom 中启动，以启用自动消息传递和完整的 hcom 功能。用户应退出并运行 
hcom <tool>
。 或者，如果你知道自己的 sessionID/ses_/thread_name，用户可以退出并运行 
hcom r <session-id>
，让当前会话在 hcom 中恢复。参见 
hcom r --help
。

troubleshooting

故障排除

"hcom not working"

"hcom 无法正常工作"

bash
hcom status          # check installation
hcom hooks status    # check hooks specifically
hcom relay status    # check cross-device relay
still broken?
bash
hcom reset all # backup config/db + reset it
hcom claude          # fresh start
still broken after that?
bash
git clone https://github.com/aannoo/hcom.git
cd hcom
Read code and figure out what is going on.
bash
hcom status          # check installation
hcom hooks status    # check hooks specifically
hcom relay status    # check cross-device relay
仍然有问题？
bash
hcom reset all # backup config/db + reset it
hcom claude          # fresh start
这样处理后仍然有问题？
bash
git clone https://github.com/aannoo/hcom.git
cd hcom
阅读代码并找出问题所在。

sandbox / permission issues

沙箱 / 权限问题

Use project-local hcom state when the normal hcom directory is unavailable:
bash
HCOM_DIR=$PWD/.hcom hcom <tool>
当常规 hcom 目录不可用时，使用项目本地的 hcom 状态：
bash
HCOM_DIR=$PWD/.hcom hcom <tool>

files

文件

whatlocation
database
~/.hcom/hcom.db
config
~/.hcom/config.toml
env
~/.hcom/env
logs
~/.hcom/.tmp/logs/
user scripts
~/.hcom/scripts/
内容位置
数据库
~/.hcom/hcom.db
配置
~/.hcom/config.toml
环境变量
~/.hcom/env
日志
~/.hcom/.tmp/logs/
用户脚本
~/.hcom/scripts/

more info

更多信息

bash
hcom --help
hcom <command> --help
hcom run docs --scripts   # script authoring info
Github: https://github.com/aannoo/hcom
bash
hcom --help
hcom <command> --help
hcom run docs --scripts   # script authoring info
Github: https://github.com/aannoo/hcom