Panegrip Docs

Setup / zellij

Panegrip with zellij

Panegrip follows every running zellij session: its panes, the agents in them and the folders they work in.

What works

FeatureWorksNotes
ChatsYesClaude Code and Codex, from their transcripts
Questions and permissionsYesAnswered from the phone
TerminalYesThe pane's screen, with keys
New workYesTabs from the phone in your latest session
Live repliesYesWords as the agent writes them
Passwords from the phoneNoNot possible: see below

Requirements

  • zellij 0.44 or later
  • An iPhone with Panegrip

Setup

  1. 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 | sh
  2. Scan 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.

  3. Run an agent in zellij.

    Start an agent in any pane of a session you have attached. It shows up within a couple of seconds.

  4. Optional: make zellij the main app.

    In Panegrip, Settings → Agents → Main app → zellij. New projects from the phone open as tabs in your most recent session.

On your phone

Panes are grouped into projects by their folder. zellij doesn't say which process a pane runs, so Panegrip lines its panes up with the processes zellij started, in order.

Note. zellij takes text only on its command line, so what you type to it from the phone can be seen by other programs on the computer for a moment. For that reason passwords can't be typed into zellij from the phone: type them on the computer.

Troubleshooting

A pane shows the wrong agent or none

Close panes zellij keeps but no longer shows, or restart the session: the line-up of panes and processes is rebuilt every second.

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.