hcom, multi-agent communication for AI coding tools

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

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:

# terminal 1
hcom claude

# terminal 2
hcom codex

Prompt normally, e.g. 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

---

what agents can do

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

---

setup

When this skill is invoked, first run:

hcom status

If hcom status works: run hcom list

If hcom list shows "Your name: <name>" where <name> is not "(not participating)": congratulations!