What is agent-comm-hub AGENTS.md?

Project instructions for AI coding agents working on agent-comm-hub, a local service that lets multiple AI agents communicate and delegate tasks through MCP.

Use them before changing agent-comm-hub to understand how agents connect, communicate, acknowledge messages, and run the zero-dependency Node.js server.

They explain the project's architecture, layout, commands, and rules that must remain intact while editing it.

How JochenYang/agent-comm-hub configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to JochenYang/agent-comm-hub. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/JochenYang/agent-comm-hub/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/JochenYang/agent-comm-hub

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/jochenyang/agent-comm-hub/agents-md/github.svg)](https://agentmods.dev/instructions/jochenyang/agent-comm-hub/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/jochenyang/agent-comm-hub/agents-md"><img src="https://agentmods.dev/badge/instructions/jochenyang/agent-comm-hub/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/jochenyang/agent-comm-hub/agents-md"><img src="https://agentmods.dev/badge/instructions/jochenyang/agent-comm-hub/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 8,634 This file is loaded in full into every session.

When invoked 8,634 The same file — it is already loaded in full.

Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.08634	$0.08634
Opus 5.5	$0.03454	$0.03454
Sonnet 5.5	$0.01727	$0.01727
Haiku 4.5	$0.00863	$0.00863

Measured 10d ago against content hash 35d10608cb6c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

agent-comm-hub AGENTS.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

credentials — `chmod 600` them, never commit them, and note that the bundled

AGENTS.md · 463 lines

How it starts

The opening of the file, as written. The whole thing — 463 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

Guidance for AI coding agents working on agent-comm-hub. Read this before editing; it explains what the project is, how it is built, and the invariants that must not be broken. If this file conflicts with a user instruction, the user instruction wins.

Project overview

agent-comm-hub is a generic multi-peer communication hub over MCP: any MCP-capable AI agent (MiniMax Code, Claude Code, opencode, Codex, Gemini CLI, DeepSeek Harness, Kimi Code, zcode, …) connects to one local streamable-http endpoint (http://127.0.0.1:18764/mcp), claims a peer id, and then chats with, delegates tasks to, and acknowledges every other connected agent in real time.

Key facts:

Zero runtime dependencies: the MCP streamable-http server is hand-rolled over node:http. No database, no daemon, no SDK. This is the project's #1 constraint — see Invariants.
One process: npx agent-comm-hub starts the hub; it is a foreground process that stops on Ctrl+C (auto-start via service install is optional).
Connect = join: the MCP handshake (initialize) auto-registers the session using the clientInfo name — no manual registration step.
Identity is server-injected: from on every message comes from the session→peer binding, never from the caller; peers cannot impersonate each other. Same-name connections share one peer id (N:1) and one mailbox.
Offline-tolerant: messages queue per peer (max 200, oldest dropped) and are delivered on the next bridge_wait/bridge_poll.
Version 0.11.0, Node ≥ 22, MIT license, npm name agent-comm-hub, package manager is pnpm (single-package repo; pnpm-workspace.yaml only carries the pnpm 10 allowBuilds approval for esbuild). The one exception is the admin/ web-console workspace, which uses npm (its own package-lock.json) and is driven from here by npm --prefix admin run build.

Architecture

The hub is a neutral "post office": it never participates in content, only registers identities, routes messages, and queues for offline peers. Five layers:

Read the full file on GitHub · 463 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

10d ago Changed · +47 lines · +1,324 tokens per session 35d10608cb6c
28d ago Changed · +36 lines · +1,123 tokens per session scan A → B a44f230c78d5
1mo ago Changed · +93 lines · +1,640 tokens per session 0e0a2f8031b8
1mo ago Changed · +9 lines · +164 tokens per session 86cb406cceae
2mo ago Changed · +6 lines · +94 tokens per session 04922e12ccf8
2mo ago First seen · 272 lines · 4,289 tokens per session scan A 320ab002aa20

Subscribe to this mod's changes

agent-comm-hub AGENTS.md is an instructions file published in the GitHub repository JochenYang/agent-comm-hub (5 stars, last pushed 11d ago), licensed MIT. It adds 8,634 tokens to every session, about $0.0345 per session on Opus 5.5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

agent-comm-hub AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
agent-comm-hub AGENTS.mdJochenYang/agent-comm-hub	Instructions file	5	11d ago	MIT	B	8,634	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	5,649	GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	today	MIT	A	4,680	Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	3,093	GitHub Copilot
vscode ai-customization.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	1,907	GitHub Copilot

agent-comm-hub: Instructions file for Codex