aannoo/hcom

What it solves

hcom is a CLI tool designed to eliminate the manual effort of copy-pasting and coordinating multiple AI coding agents. It allows different AI CLIs to communicate, monitor each other, and spawn new agents across different terminal windows or devices, enabling the creation of multi-agent pipelines without manual intervention.

How it works

The tool uses hooks that record agent activity into a local SQLite database. Messages and events are delivered via this database, creating a communication bridge between agents. For cross-device connectivity, it uses an MQTT relay with end-to-end encryption. It integrates with various AI CLIs (like Claude Code, Gemini, and Copilot) by wrapping them or using specific hooks, allowing agents to send messages, observe terminal screens, and trigger actions like spawning or killing other agents.

Who it’s for

It is built for developers who use multiple AI coding assistants and want to automate their workflows by letting these agents collaborate, review each other's work, or split complex tasks across several instances.

Highlights

• Multi-Agent Coordination: Agents can message each other in real-time, observe transcripts and file edits, and subscribe to specific events.
• Agent Lifecycle Management: Ability to spawn, fork, resume, and kill agents across various terminal emulators (e.g., Kitty, WezTerm, tmux).
• Cross-Device Support: Connect agents across different machines using an encrypted MQTT relay.
• Extensible Workflows: Includes built-in scripts for patterns like debates, honesty self-evaluations, and idle-triggered tasks.
• Broad Compatibility: Works with a wide range of AI CLIs including Claude, Gemini, Codex, and Cursor.