Setup / tmux
Panegrip with tmux
Run your agents in tmux as you always have. Panegrip finds them by their processes, in every tmux server, Claude Code's agent teams included.
What works
| Feature | Works | Notes |
|---|---|---|
| Chats | Yes | Claude Code and Codex, from their transcripts |
| Questions and permissions | Yes | Answered from the phone |
| Terminal | Yes | The pane's screen, with keys |
| Live replies | Yes | Words as the agent writes them |
| New work | Yes | Sessions and windows from the phone |
| Forks and handoffs | Yes | In a split beside the agent |
Requirements
- tmux on a Mac or Linux computer
- An iPhone with Panegrip
Setup
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 | shScan 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.
Run an agent in tmux.
Start Claude Code, Codex or another agent in any tmux pane. It shows up within a couple of seconds, grouped by the folder it works in.
tmux new -s workOptional: make tmux the main app.
In Panegrip, Settings → Agents → Main app → tmux. A new project from the phone then opens as a tmux session named after its folder. Attach to it on the computer:
tmux attach -t <folder>
On your phone
Panes are grouped into projects by their folder, so one repository shows once, whichever panes and apps its agents run in. Plain shells show too, as terminals.
Note. Text from the phone goes in through a tmux paste buffer, never on a command line where other programs could read it.
Troubleshooting
An agent doesn't show
Panegrip looks for agents among the processes of each pane. Make sure it runs in the pane itself, not over ssh to another machine.
Does it see my private tmux servers?
Yes, every server whose socket is in tmux's folder, including the ones started with -L name and the one Claude Code's agent teams start.
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.