| name | herdr-messaging |
| description | Message existing AI agents (Claude, pi and others) running in herdr terminal panes, on this machine or a remote one over SSH. Use when the user asks you to contact another agent, hand work off to one, check what one is doing, or reply to a message from one. Also use when the user names an agent or a pane. |
Message other agents through herdr
herdr is a terminal workspace manager. Each AI agent runs in a pane. You can find agents, read their screens and type into their input boxes using the herdr CLI. A message you submit into an agent's pane arrives as a normal user message in that agent's conversation.
Find agents
List agents on this machine:
herdr agent list
List agents on a remote machine:
ssh <user>@<host> 'export PATH="$HOME/.local/bin:$PATH"; herdr agent list'
You must export PATH because non-interactive SSH does not load the profile that puts ~/.local/bin on it.
Each entry gives you a pane id (like w3:p1), the agent kind, its status and its working directory. To tell similar agents apart, read the pane. The agent's own name is usually in its status line:
herdr agent read <pane-id> --source visible --lines 20
herdr workspace list shows workspace labels, which often name the project.
Identify yourself in every message
Messages carry no envelope. The receiving agent cannot tell your message from one typed by the user. So the message itself must say who you are and how to reply.
Start every message with a from line and a reply-to line:
[agent-msg] from: <your-session-name>@<machine> (<agent kind>, pane <your-pane-id>, <your-cwd>)
reply-to: herdr pane send-text <your-pane-id> '<text>'; for i in 1 2 3; do herdr pane send-keys <your-pane-id> enter; sleep 0.4; done
