Terminals
Every terminal your agents run in.
Click a session in Perch and land in the exact pane, split, tab or conversation in six apps, the right pane inside tmux, herdr and Zellij, and the right app everywhere else.
Six apps Perch lands in precisely
| App | Lands on | How | Permission |
|---|---|---|---|
| exact pane | Warp's own focus link | None | |
| exact pane | iTerm2's reveal link | None | |
| exact pane | Rex's own server | None | |
| exact split | AppleScript, by the session's tty | Automation, asked once | |
| exact tab | AppleScript, by the session's tty | Automation, asked once | |
| exact conversation | The app's codex:// link | None |
Inside tmux, herdr and Zellij
A session inside a multiplexer gets its pane selected first, then the terminal showing it comes forward — whichever of the terminals above that is.
| Multiplexer | A click selects | Replies from your phone |
|---|---|---|
| tmux | Window and pane | Yes |
| herdr | Pane | Yes |
| Zellij | Tab and pane | No |
Replying to agents in tmux and herdr, and why Zellij gets the jump only.
Where your phone can type a reply
Typing from the iPhone is a Perch Pro feature, and it needs a pane Perch can address without the screen. Approvals don’t: they work in every terminal.
| Where the session runs | Replies | Worth knowing |
|---|---|---|
| tmux or herdr, in any terminal | Yes | Into the agent's own pane, with the Mac locked. Droid: tmux, not herdr. |
| Rex | Yes | Through Rex's own server, no tmux needed. |
| Codex in its default mode | Yes | Through Codex's background service, whatever the terminal. |
| OpenCode | Yes | Through OpenCode's own server. OpenCode 1 needs --port. |
| A plain Warp, iTerm2, Ghostty or Terminal tab | No | Run the agent inside tmux or herdr there. The Mac notification can still take a reply. |
And everywhere else, the right app
kitty, WezTerm, Alacritty, Hyper, Tabby, VS Code, Cursor, Windsurf don’t offer a way to pick a pane, so a click brings the app forward. Claude Desktop is raised the same way, and a terminal Perch doesn’t recognise is opened by name, as a best effort.
Running something that isn’t here? Tell us.
Questions