repowiseaannoo/hcom

aannoo / hcom

Let AI agents message, watch, and spawn each other across terminals. Claude Code, Codex, Antigravity CLI, Cursor CLI, OpenCode, Kilo, Pi, Kimi

Rust★ 590
Use in your agentAsk this codebase

github.com/aannoo/hcomIndexed at de33e31Up to date with upstream

What is hcom?

hcom is a Rust command-line tool for connecting independent coding agents across terminals and machines. It lets agents message each other, monitor activity, react to events, and launch additional agents. hcom uses hooks and a local SQLite database to record activity and deliver messages.

Written by a model from the README and the source

242 files and 10,522 symbols in 4 modules, led by Rust (198 files) and Shell (8).

Start reading

Code health

5.1out of 10Needs work

Hotspots average 3.6, the place fixes pay off most.

Full health report

On the leaderboards:#11 of 14 Rust repos

Use aannoo/hcom in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/aannoo/hcom
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is hcom put together?")
  • get_why("why is hcom structured this way?")

Explore hcom

Key features of hcom

  • hcom lets coding agents message each other in real time across terminals and machines.
  • hcom lets users observe agent status, transcripts, tool results, file edits, commands, terminal screens, and context or token usage.
  • hcom lets agents subscribe to status changes, commands, file edits, collisions, and session events, then react automatically.
  • hcom can spawn, fork, resume, and kill agents in terminal or headless environments.
  • hcom connects agents across machines through an MQTT relay.

How aannoo/hcom works

Agents enter hcom through launch commands such as hcom claude or hcom codex. src/launcher.rs starts agents in supported terminal environments, while src/hooks/claude.rs integrates activity hooks for Claude. Hooks record activity in a local SQLite database, and src/delivery.rs delivers messages from the database to other agents. src/terminal.rs manages visible terminal sessions and terminal interaction. src/commands/resume.rs handles resuming agent sessions, while hcom send and hcom events support messaging and event-driven scripts.

The codebase has 242 files and 10,522 symbols in 4 modules, led by Rust, Shell and TypeScript. Code health is 5.1 out of 10, rated needs work.

Getting started with hcom

  1. Install hcom with uv.
    uv tool install hcom
  2. Launch agents in separate terminals.
    hcom claude
  3. Launch another agent in a second terminal.
    hcom codex

Commands copied from the README

aannoo/hcom FAQ

What is hcom?

hcom is a command-line tool for connecting independent coding agents across terminals and machines. It supports messaging, activity monitoring, event reactions, and agent launching.

How does hcom work?

hcom uses hooks to record agent activity in a local SQLite database and deliver messages to other agents. Agents launched with hcom receive this integration.

How do I install hcom?

hcom can be installed with uv using uv tool install hcom. The project also provides Homebrew and installer-script options.

What language is hcom written in?

hcom is written primarily in Rust. Its repository also includes shell, TypeScript, JavaScript, and Python files.

How is the hcom code organized?

hcom's main source code is in src, with tests in tests and utility files in scripts. Entry points include src/main.rs, src/bootstrap.rs, src/commands/run.rs, and src/commands/start.rs.

Who is hcom for?

hcom is for people coordinating coding agents across terminals and machines. It supports multi-agent pipelines, AI CLI subagents, and workflows that avoid copy-pasting.

What license does hcom use?

hcom uses the MIT license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of aannoo/hcom from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.