Panegrip Docs

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

  1. You run your agents as usual: in Herdr, Orca, T3 Code, tmux, zellij, cmux, Ghostty or VS Code.
  2. The relay, a small program on the same computer, finds the agents and reads their conversations.
  3. 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

AppTypeWhat Panegrip shows
HerdrTerminal multiplexerThe terminal multiplexer for coding agents. Everything Panegrip does works here.
OrcaAgent IDEStably's agent IDE. Its worktrees and terminals show beside everything else.
T3 CodeAgent workbenchT3 Code's threads, followed as one more client of its server.
tmuxTerminal multiplexerEvery tmux server on the computer, its panes and the agents in them.
zellijTerminal multiplexerzellij sessions with a client attached: their panes and agents.
cmuxTerminal for agentsThe Ghostty-based terminal for agents: its workspaces and surfaces.
GhosttyTerminalAgents running right in Ghostty's windows, Ghostty 1.3 or later.
VS CodeEditorClaude Code's VS Code extension, in VS Code, Cursor and Windsurf.
Everywhere elseRead-onlyClaude 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.