Setup / Herdr
Panegrip with Herdr
Herdr runs your agents in panes and knows what each is doing. Panegrip mirrors its workspaces, worktrees and panes as projects and chats on your phone.
What works
| Feature | Works | Notes |
|---|---|---|
| Chats | Yes | Every agent's conversation, as it happens |
| Questions and permissions | Yes | Answered with a tap, from notifications too |
| Terminal | Yes | The pane's screen, with keys |
| New work | Yes | Projects, worktrees, agents and terminals from the phone |
| Live replies | Yes | Words as the agent writes them |
| Usage | Yes | Claude and Codex limits at a glance |
Requirements
- A Mac or a Linux computer
- Herdr installed and running
- An iPhone with Panegrip
Setup
Install Herdr and start it.
Follow herdr.dev, then run your agents in it as usual: Claude Code, Codex, OpenCode and the others it knows.
Install the relay on the computer.
One command in a terminal on the Mac or Linux computer your agents run on. It downloads the relay for your machine, checks its SHA-256, installs it to
~/.local/bin, starts it in the background (it starts again at login) and shows a QR code.curl -fsSL https://get.panegrip.dev | shScan the code with Panegrip.
Install Panegrip on your iPhone from the App Store, open it and tap Connect a computer. Point the camera at the QR code. The code works once, for ten minutes; for another phone run
panegrip-relay pair.The phone and the computer talk end to end encrypted, directly when they can. Your code never goes through a server of ours.
On your phone
Each Herdr workspace becomes a project with its branch and uncommitted changes; its panes become chats. A working agent shows as working; one that asks something shows as waiting, and you get a notification you can answer from the Lock Screen.
Main app. Herdr is the main app unless you choose another: new projects, agents and terminals from the phone open as Herdr workspaces and tabs.
Troubleshooting
The app says Herdr isn't answering
Check that Herdr's server runs on the computer (herdr status). The relay waits for it and the list comes back by itself.
An agent shows as working when it's done
Herdr learns an agent's state from a small hook in it. Panegrip's checkup lists agents without one; install it from there.
Something else is wrong
Open Checkup in Panegrip: it shows what each app on the computer is doing. Or write to support@panegrip.dev; a person reads every message.