Skip to content
Terminalsherdr

Agents in herdr, answerable from your phone.

herdr already knows which agent runs in which pane. Perch uses that to land on the right one with a click, and to let your iPhone type into it and stop a turn while your Mac stays locked.

herdr with Perch

Lands on
The agent's pane, any workspace
Phone replies
Yes, with Perch Pro
Stop
Claude Code, Codex, Antigravity
Matched by
The agent's own session id
Permission
None

How the jump works

herdr finds the pane, then the terminal comes forward

Matched by session, not guessed

herdr detects the agents in its panes and reports each one's session id. Perch matches that against the session it already knows, exactly, so there's no walking the process tree and no chance of a lookalike pane.

Across workspaces and tabs

A click asks herdr to switch to the agent's pane, wherever it is in your workspaces and tabs, and then raises the terminal running herdr. herdr has no window of its own, so the terminal is the part you see arrive.

Found on the click

The pane is looked up when you click and never stored. herdr renumbers a pane that moves between workspaces, so a remembered one could name a stranger's. Every server you run is asked, named sessions included.

Answering

Typing into the agent's own pane

Reply from your iPhone

With Perch Pro, type a full message, line breaks and all, and herdr pastes it into the agent's own pane. Nothing touches the keyboard or the screen, so the Mac can stay locked. It works for Claude Code, Codex, Cursor, Devin, Amp and Antigravity; OpenCode takes replies through its own server instead, wherever it runs.

Stop a turn that's going wrong

For Claude Code, Codex and Antigravity, each measured before it was offered. Stop sends one Escape through herdr, never Ctrl-C. Devin's and Amp's interrupt keys do something else, so they get none.

Reply from the Mac notification

An answer typed into a Mac notification goes to the session's own pane through herdr, not to whichever pane is in front, and needs no Accessibility access, since nothing is typed on screen.

How approving from your iPhone works, running Claude Code from your phone, and every alert Perch can send you.

Worth knowing

The conditions, named

No reply while a prompt is up

Perch sends replies through herdr's own prompt command, which refuses while the agent is blocked on a permission or a question. Answer it with Allow or Deny first, from the phone, the watch or the Mac.

A click marks the tab as seen

herdr flags a tab whose agent finished while you weren't looking. Jumping to it with Perch counts as looking, so the flag clears, the same as switching to it yourself. Perch only does this when you click, never in the background.

Droid is watched, not answered

Droid's replies, Stop and Allow/Deny were measured in tmux, so that's where Perch answers it. A Droid session in herdr shows on the fleet like any other, and you answer it at the terminal.

A herdr update can get ahead of Perch

Perch reads only the versions of herdr's interface it has been checked against, and refuses a newer one rather than guess at it. If herdr changes it, a click raises the terminal without picking the pane, and replies inside herdr wait for a Perch update. Your sessions, alerts and approvals carry on, since they come from Perch's own hooks.

Pay once for the fleet. Subscribe for the conversation.

Solo

$29one-time
  • Lifetime license — pay once, keep it
  • One Mac at a time; deactivate in-app to move
  • iOS companion, push alerts & Live Activities included
  • Notarized app with signed automatic updates
Buy Perch — $29

Team

$29per seat, one-time · 2+ seats
5
seats × $29 = $145
  • A license key for every teammate — not one shared key
  • Assign and revoke seats by email from your customer portal
  • Your seat is claimed on purchase; invite the rest by email
  • Same lifetime license and updates on every seat
  • Perch Pro is separate — each teammate who wants it subscribes in the iPhone app
Buy 5 seats — $145

Pro

Most popular
$4.99per month

or $29 a year

Launch price until 15 November, then $49 a year

  • A Mac app licence included, for as long as you subscribe — nothing separate to buy
  • Read your agents’ conversations from your iPhone, and reply straight back into the session
  • Works with your Mac locked, from anywhere your phone can reach it*
Get it on the App Store

Free to download. Pro is an in-app purchase.

* What Pro can reach depends on the agent and on where its session is running. Replying needs the session inside tmux, herdr or Rex (Droid, tmux or Rex) — Codex in its default mode and OpenCode use their own local servers instead — and it has to be switched on in Settings, because paying for Pro is not the same as consenting to remote input. Reading a conversation works wherever the session runs. Each agent’s own page says exactly what it supports, and what it doesn’t.

Questions

herdr and Perch, specifically

Can I reply to Claude Code running in herdr from my iPhone?
Yes, with Perch Pro — a subscription bought in the iPhone app. Your message goes into the agent's own herdr pane, multi-line included, and your Mac can stay locked. Typing has to be switched on in Perch's Settings as well, because paying for Pro isn't consent to remote input.
Does Perch need herdr, or tmux, to work?
No. Perch watches every session and takes approvals in any terminal. herdr, tmux or Rex matter only for typing replies and Stop from the phone, because Perch won't type into a pane it can't name without the screen, and a plain terminal tab can only be typed into by pressing keys on it.
Does clicking a session switch my herdr workspace?
Yes. Perch asks herdr to switch to the agent's pane, across workspaces and tabs in one step, and then brings forward the terminal herdr is running in.
What about Codex in herdr?
Both kinds of Codex session work. In Codex's default mode Perch can reach a session through Codex's own background service whatever the terminal, and inside herdr a session the service hosts takes replies through herdr too. A session started with --no-daemon takes them through herdr like any other agent.

Perch lands precisely in Warp, iTerm2, Rex, Ghostty, Terminal.app and Codex Desktop, and inside tmux and Zellij. Every terminal Perch supports.