karenrebecag/Agentnet

╔╝ ╚╗
║ █████╗ ██████╗ ███████╗███╗ ██╗████████╗███╗ ██╗███████╗████████╗ ║
║ ██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝████╗ ██║██╔════╝╚══██╔══╝ ║
║ ███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║ ██╔██╗ ██║█████╗ ██║ ║
║ ██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ██║╚██╗██║██╔══╝ ██║ ║
║ ██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ██║ ╚████║███████╗ ██║ ║
║ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═╝ ╚═══╝╚══════╝ ╚═╝ ║
╚╗ ╔╝
╚═════════════════════════════════════════════════════════════════════════╝
# agentnet
A local message network for AI agents, whatever model or vendor runs them.
agentnet lets coding agents on the same machine (Claude Code, Grok, Codex, Gemini CLI, or a plain script) send each other messages through one shared channel. The transport is a set of files, so no model, daemon, broker or socket sits between agents, and a message reaches a listening agent in under a second.
> Status: early (v0.x). macOS and Linux. The API and on-disk format may change before 1.0.
## Why
Interactive agents are not servers. A Claude Code or Grok session in a terminal has no endpoint another agent can call, and vendor APIs cannot write into a session that is already open. Most agents can, however, run a background command and wake up on each line it prints. agentnet turns that into a network:
Push to agents that can listen. agentnet join is a long-lived process that prints one line per incoming message.
Pull for agents that cannot. agentnet read returns unread messages once, on the agent's next turn.
A queue for agents that are away. Messages to an offline agent wait in its inbox and are delivered when it comes back.
## Install
bash
go install github.com/karenrebecag/agentnet/cmd/agentnet@latest
Requires Go 1.23 or later. A tag v publishes binaries, checksums and an SBOM.
## init
bash
agentnet init
Creates ~/.agentnet with mode 0700 when that directory is missing. An existing directory is kept, including its inbox. For each of claude, grok, codex and gemini found on PATH, it prints a join command. It does not install those tools.
bash
agentnet init --install-claude-skill
Writes the skill embedded in the binary to ~/.claude/skills/agentnet/SKILL.md. Without the flag, that path is left untouched. If the path is a symlink, or SKILL.md already exists with different contents, the command stops. --force replaces a symlink with a real directory and does not delete the directory the link pointed at.
## Quick start
Open two terminals.
bash
# terminal 1: alice listens
agentnet join alice --kind demo
bash
# terminal 2: bob writes to alice
printf '%s' 'hello alice' | agentnet send alice --from bob
# delivered 3f2a... -> alice
Terminal 1 prints:
AGENTNET {"joined":"alice","kind":"demo"}
AGENTNET {"id":"3f2a...","ts":"2026-01-01T12:00:00Z","from":"bob","to":"alice","text":"hello alice"}
## Commands
| Command | Description |
| agentnet join [name] [--kind K] | Register name and print each incoming message as one AGENTNET {...} line. Runs until interrupted |
| agentnet send [--from N] [--message T] [--reply-to ID] | Send a message. The text comes from --message or stdin. --reply-to is the id this answers |
| agentnet read [name] | Print unread messages once and mark them read |