A local message bus and event log that enables AI agents to communicate, observe, and spawn each other across terminals.
hcom is a command-line tool that enables AI agents to communicate and collaborate across terminals. It acts as a local message bus and event log, allowing agents like Claude Code, Gemini CLI, Codex, and OpenCode to send messages, observe each other's activities, and spawn new instances. It solves the problem of isolated AI tool sessions by facilitating multi-agent workflows and coordination.
Developers and researchers working with multiple AI coding assistants who need to orchestrate collaborative tasks, automate workflows, or enable cross-agent communication in terminal environments.
Developers choose hcom for its seamless integration with popular AI CLI tools via automatic hooks, its lightweight local-first architecture, and its rich feature set for scripting multi-agent interactions without requiring complex infrastructure.
Let AI agents message, watch, and spawn each other across terminals. Claude Code, Gemini CLI, Codex, OpenCode, Antigravity CLI
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Automatically installs hooks in supported AI tool configs (Claude, Gemini, Codex, OpenCode) to enable message delivery and activity tracking without modifying the underlying tools, as described in the 'How it works' section.
Provides a full CLI suite for agent messaging, observation, spawning, and event subscriptions, with bundled scripts for workflows like debates and file monitoring, detailed in the reference and scripts sections.
Operates as a local message bus and event log using a database, ensuring minimal latency and no external dependencies for basic use, aligning with its philosophy of seamless integration.
Supports MQTT relay for connecting agents across different machines, enabling distributed workflows with simple token-based setup, as shown in the 'Cross-device' section.
Requires hooks to be installed in AI tool config directories, which can be intrusive, may break with tool updates, and adds setup complexity compared to purely external tools.
Full lifecycle management (kill/close) only works with kitty, wezterm, and tmux, as noted under 'Terminal', restricting flexibility for users of other terminals.
Creating custom workflows involves mastering hcom's event system, CLI commands, and script templates, which can be overwhelming for users seeking simple automation.