Panegrip Docs

Setup / cmux

Panegrip with cmux

cmux puts agents in workspaces with notifications of its own. Panegrip talks to cmux over its socket once cmux lets it in.

What works

FeatureWorksNotes
ChatsYesClaude Code and Codex, from their transcripts
Questions and permissionsYesAnswered from the phone
TerminalYesThe surface's screen, with keys
New workYesWorkspaces from the phone
Live repliesYesWords as the agent writes them
Forks and handoffsYesIn a split beside the agent

Requirements

  • cmux on a Mac
  • 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. Let the relay talk to cmux.

    In cmux open Settings → Automation → Socket control mode and choose Automation mode.

    By default cmux only lets programs started inside its own terminals use its socket. Automation mode lets in programs of your own macOS user, the relay among them; other users still can't.

  4. Optional: make cmux the main app.

    In Panegrip, Settings → Agents → Main app → cmux. New projects from the phone open as cmux workspaces, shown on screen: cmux starts a terminal only once its workspace has been seen.

On your phone

Surfaces are grouped into projects by their folder. The checkup shows cmux as connected once Automation mode is on, and says what to switch while it isn't.

Troubleshooting

The checkup says cmux lets only its own terminals in

Automation mode isn't on yet: see step 3. The change applies at once.

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.