Panegrip Docs

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

FeatureWorksNotes
ChatsYesEvery agent's conversation, as it happens
Questions and permissionsYesAnswered with a tap, from notifications too
TerminalYesThe pane's screen, with keys
New workYesProjects, worktrees, agents and terminals from the phone
Live repliesYesWords as the agent writes them
UsageYesClaude and Codex limits at a glance

Requirements

  • A Mac or a Linux computer
  • Herdr installed and running
  • An iPhone with Panegrip

Setup

  1. 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.

  2. 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 | sh
  3. Scan 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.