Setup overview
Panegrip is an iPhone app for the coding agents on your computer: Claude Code, Codex, OpenCode, Gemini CLI and others. Your agents keep running where they do now. A small relay on the same computer finds them and connects them to your phone.
How it works
- You run your agents as usual: in Herdr, Orca, T3 Code, tmux, zellij, cmux, Ghostty or VS Code.
- The relay, a small program on the same computer, finds the agents and reads their conversations.
- Panegrip on your iPhone shows them in one list. You answer questions, approve commands and give new work from anywhere.
The phone and the computer talk end to end encrypted, directly when they can. Your code never goes through a server of ours.
Install the relay
Run this in a terminal on the Mac or Linux computer your agents run on:
curl -fsSL https://get.panegrip.dev | sh
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. Run it again later to update.
Connect your phone
Install Panegrip from the App Store, tap Connect a computer and scan the QR code. The code works once, for ten minutes. To show a new one:
panegrip-relay pair
Supported apps
| App | Type | What Panegrip shows |
|---|---|---|
| Herdr | Terminal multiplexer | The terminal multiplexer for coding agents. Everything Panegrip does works here. |
| Orca | Agent IDE | Stably's agent IDE. Its worktrees and terminals show beside everything else. |
| T3 Code | Agent workbench | T3 Code's threads, followed as one more client of its server. |
| tmux | Terminal multiplexer | Every tmux server on the computer, its panes and the agents in them. |
| zellij | Terminal multiplexer | zellij sessions with a client attached: their panes and agents. |
| cmux | Terminal for agents | The Ghostty-based terminal for agents: its workspaces and surfaces. |
| Ghostty | Terminal | Agents running right in Ghostty's windows, Ghostty 1.3 or later. |
| VS Code | Editor | Claude Code's VS Code extension, in VS Code, Cursor and Windsurf. |
| Everywhere else | Read-only | Claude Code in the Claude desktop app, or in a terminal Panegrip can't reach. |
You can use several at once: projects from different apps show in one list, and a folder used by two apps shows once.
Main app
One app is your main app: new projects, agents and terminals you start from the phone open there. Its projects show without a tag; the others carry a small tag with the app's name. Change it in Settings → Agents → Main app.
Not on the list
Use something else? In Panegrip open Settings → Your app isn't here? Ask for it, or write to support@panegrip.dev. What people ask for decides what comes next.