Panegrip Docs

Setup / Ghostty

Panegrip with Ghostty

Ghostty is a terminal, not a multiplexer: Panegrip shows the agents running in its windows and talks to it over AppleScript.

What works

FeatureWorksNotes
ChatsYesClaude Code and Codex, from their transcripts
Questions and permissionsYesAnswered from the phone
Prompts and keysYesTyped into Ghostty
New workYesTabs from the phone
Live repliesYesWords as the agent writes them
Terminal viewNoGhostty doesn't let other apps read its screen

Requirements

  • Ghostty 1.3 or later 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. Run an agent in Ghostty.

    Start an agent in a Ghostty window. The first time, macOS asks whether panegrip-relay may control Ghostty: allow it. You can change it later in System Settings → Privacy & Security → Automation.

  4. Optional: make Ghostty the main app.

    In Panegrip, Settings → Agents → Main app → Ghostty. New projects from the phone open as Ghostty tabs.

On your phone

Only windows running an agent show; a Ghostty window with a plain shell isn't a project. With no screen to read, an agent waiting at its very first question (trusting a folder) shows as waiting: answer it on the computer or with the keys from the phone.

Troubleshooting

macOS never asked, and nothing shows

Panegrip asks Ghostty only while an agent runs in it. If you said no once, allow panegrip-relay in System Settings → Privacy & Security → Automation → Ghostty.

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.