Pending You for Herdr
Herdr runs your coding agents in panes. The plugin shows which ones are waiting on you, and what for, and answers their cards with a key, without leaving the terminal.
What it does
Each waiting agent’s row says so, with its card’s question. A toast when a pane gains a card, a key to the next one, and a popup where you answer them.
| Key or action | What it does |
|---|---|
prefix+y | The popup: your cards, most pressing first, each with who asked and where. Signed in, a key answers the one you’ve chosen. |
prefix+shift+y | The next pane waiting on you: blocking first, then by urgency. |
Pending You: set up | Toasts, the sidebar’s card line, the keys, signing Herdr in and the Agents view, each on a yes. |
Pending You: unconfigure | Takes everything off again and signs Herdr out: Herdr has no uninstall step. |
Set up
On the computer the Herdr server runs on, in one of its panes. The last line opens Pending You: set up.
| npx -y pendingyou@latest init |
| herdr plugin install recordplane/herdr-pendingyou |
| herdr plugin action invoke setup --plugin pendingyou.herdr |
Answering
Sign Herdr in and the popup answers your cards: a key for each option, y and n for an approval, your own words, Later, handing a card to another agent, and 5 seconds to take it back. It’s the first app on the person API.
| npx pendingyou app login herdr |
Or say yes when setup asks. Your phone shows a card for it: Herdr, this computer, what it may do, and Allow as a press and hold. The agent that asked hears your answer as it would from anywhere else.
- Only this computer’s cards.It signs in on the computer it runs on, and sees the cards of that computer’s assistants unless you tick every card.
- Never high stakes.A card that spends money, can’t be undone or goes public opens in Pending You instead.
- It says so.Its answers read “You answered in Herdr on build-01” on the card, and your phone stays quiet for build-01’s cards while you’re active in Herdr.
- You can take it back.Remove it in Settings › Apps and devices, or run npx pendingyou app logout herdr. Its sign-in lasts 30 days.
Keys
In the popup, on the card you’ve chosen. ↑ and ↓ (or j and k) choose another.
| Key | What it does |
|---|---|
1–9 | Answers with that option. On a card that takes several, chooses it; Enter sends. |
y, n | Approve or decline. On a review, looks good or needs changes; on a step, done or didn’t work. |
Enter | Writes an answer in your own words, then Enter sends it. Sends a card that takes several. |
r | Writes to the agent that asked. |
l | Later: 1 in an hour, 2 tonight, 3 tomorrow morning. |
d | Hands the card to another agent: 1 it answers the asker directly, 2 it answers you first. |
u | Takes back the last answer, Later or handover, for 5 seconds. |
t | Goes to the agent’s pane. |
o | Opens the card in Pending You. |
a | Opens all your cards in Pending You. |
q, Esc | Closes the popup. |
What it keeps
On the computer, in your own folders, readable only by you.
| File | What’s in it |
|---|---|
~/.config/pendingyou/machine.json | The computer’s key, which proves which computer a sign-in is on. Never sent. |
~/.config/pendingyou/apps/herdr.json | Herdr’s sign-in, and the key its tokens are bound to. 0600. |
~/.config/pendingyou/herdr.json | Whether the badges are on. |
The plugin’s state folder | Its watcher’s lease, whether it’s on, the Agents view, and when you last pressed a key in the popup. |
What it sends
Into Herdr: each waiting agent’s app, its name, how many cards wait, the most pressing card’s title (shortened, at most 80 characters) and how pressing. Never an answer or anything else of a card.
To Pending You, with each agent’s presence: the pane it runs in (w2:p1) and a hash naming the Herdr server, so the plugin can go from a card to its pane. Never the socket’s path or anything in the pane.
Signed in, as Herdr: the keys you press in the popup, and that you’re active in Herdr. The popup shows your cards only on your screen and writes none of them anywhere.
How it was checked
| Date | What | Result |
|---|---|---|
| 2026-10-05 | A throwaway Herdr 0.9.3 server on a Linux computer (build-01), with stand-in agents in its panes: badges on each pane, the popup, the next-pane key, a toast for a new card, setup writing the sidebar block, and unconfigure taking everything off. | Passed |
| 2026-10-06 | A real Herdr 0.9.3 on build-01 with a Mac client (work-mbp) attached over herdr --remote, and real Claude Code sessions in its panes: the badge, the waiting line and toasts on the Mac, and both keys. | Passed |
| 2026-10-06 | Signing in and answering against a stand-in Herdr and a stand-in Pending You: every kind of card and its keys, Later, handing over, undo, and a high-stakes card never answered whatever is pressed. | Passed |
| Pending | Answering a real Claude Code card from the popup, and the agent waking in its pane. | Pending |
| Pending | A real Codex thread, and real OpenCode and Pi sessions. | Pending |