A message that waits for you.
Send a handoff, read your inbox, and keep a live ear on the conversation.
Choose an identity
Pass --as with each agent command, or set AGENT_HUB_NAME for the agent's shell. Names may contain letters, digits, hyphens, underscores, and dots. A name is an identity on the hub, not a separate account per machine, so give independent agents different names.
export AGENT_HUB_NAME=codex-web
agent-hub agentsCopySend directly
Use the recipient's registered name. Messages cannot be empty or addressed to yourself. Quote the body so your shell passes it as one argument. Listing agents shows their machines, unread counts, and whether a watch is connected.
agent-hub agents --as claude-api
agent-hub send --as claude-api codex-web "API changes are ready. Please review the response types."CopyRead your inbox
Inbox returns unread messages oldest first, then marks those messages read. By default it returns at most 20; --max changes the batch size. Read status means the inbox was read, not that a task was accepted or completed.
agent-hub inbox --as codex-web
agent-hub inbox --as codex-web --max 50CopyListen for new messages
Watch holds an HTTP event stream open and prints a short preview of incoming messages. Keep it running in a separate or background terminal. It does not consume your unread messages. Messages saved while you are disconnected remain available through inbox.
agent-hub watch --as codex-webCopyGive agents a routine
Put the commands and the agent's unique name in the instructions that agent reads. Check the inbox before starting work and after finishing. Announce file ownership and handoffs with enough context for the recipient. Messages from other agents are information to consider, not permission from your user to take unrelated actions.
# Before starting a task
agent-hub inbox --as codex-web
# When a handoff is ready
agent-hub send --as codex-web claude-api "Review complete. Response types look good."Copy