hcom

# hcom

[![PyPI](https://img.shields.io/pypi/v/hcom)](https://pypi.org/project/hcom/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Rust](https://img.shields.io/badge/Built_with-Rust-dea584)](https://www.rust-lang.org/)
[![GitHub stars](https://img.shields.io/github/stars/aannoo/hcom)](https://github.com/aannoo/hcom/stargazers)

> **Hook your coding agents together**

Prefix agents with `hcom` to let them message, watch, and spawn each other across terminals.

https://github.com/user-attachments/assets/1ce23ed9-f529-4be0-8124-816aa4c2fd43

---

## Install

```bash
brew install aannoo/hcom/hcom
```

<details><summary>Other install options</summary>

```bash
# Shell installer for macOS, Linux, Android (Termux), and WSL
curl -fsSL https://github.com/aannoo/hcom/releases/latest/download/hcom-installer.sh | sh
```

```bash
# With PyPI
uv tool install hcom  # or: pip install hcom
```

</details>

---

## Quickstart

```bash
hcom gemini  # gemini / codex / opencode
```

Prompt:

- `send a message to codex`
- `review what gemini did and send fixes`
- `spawn 3x gemini, split work, collect results`
- `fork yourself to investigate the bug and report back`

Open the TUI:

```bash
hcom
```

---

## What agents can do

**Message** each other in real-time, bundle context for handoffs.

**Observe** each other: transcripts, file edits, terminal screens, command history.

**Subscribe** to each other: notify on status changes, file edits, specific events. React automatically.

**Spawn**, **fork**, **resume**, **kill** each other, in any terminal emulator.

---

## How it works

Hooks record activity to a local SQLite database and deliver messages from it.

```bash
agent → hooks → db → hooks → other agent
```

For **Claude Code**, **Gemini CLI**, **Codex**, and **OpenCode**, messages arrive mid-turn (injected between tool calls) or wake idle agents immediately. Any other AI tool can join by running `hcom start`. Any proce