# Hcom Agent Messaging

Multi-agent communication for AI coding tools.

- Repository: https://github.com/aannoo/hcom (622 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-21
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add aannoo/hcom --skill hcom-agent-messaging -g -a claude-code -y`
Codex: `npx skills add aannoo/hcom --skill hcom-agent-messaging -g -a codex -y`
Cursor: `npx skills add aannoo/hcom --skill hcom-agent-messaging -g -a cursor -y`
Gemini CLI: `npx skills add aannoo/hcom --skill hcom-agent-messaging -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add aannoo/hcom`

## Description

Multi-agent communication for AI coding tools. Agents message, watch, and spawn each other across terminals. Use when setting up hcom or troubleshooting.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

```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
# 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:

```bash
hcom status
```

If hcom status works: run `hcom list`

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

The rest: https://github.com/aannoo/hcom/blob/HEAD/skills/hcom-agent-messaging/SKILL.md