Panegrip Docs

Setup / Orca

Panegrip with Orca

Orca runs agents in worktrees of your repositories. Panegrip follows Orca while it's open: its worktrees become projects, the agents in its terminals become chats.

What works

FeatureWorksNotes
ChatsYesEvery agent in Orca's terminals
Questions and permissionsYesAnswered from the phone
TerminalYesThe terminal's screen, with keys
New workYesWorktrees, agents and terminals in Orca from the phone
Live repliesYesWords as the agent writes them
Forks and handoffsYesInto a new Orca terminal

Requirements

  • A Mac with Orca
  • An iPhone with Panegrip

Setup

  1. Open Orca.

    Install Orca and open it. Panegrip finds it by itself while it runs; there is nothing to connect.

  2. 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
  3. 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.

  4. Optional: make Orca the main app.

    In Panegrip, Settings → Agents → Main app → Orca. New projects, agents and terminals you start from the phone then open in Orca.

On your phone

Each Orca worktree is a project; a folder Herdr also has shows once, with the agents of both. Projects and chats from apps other than your main one carry a small tag.

Troubleshooting

Orca's agents don't show

Orca must be open: Panegrip follows it while it runs. If git stopped working after an Xcode update, Orca's worktrees disappear; the checkup says so and how to fix it.

Agents started from the phone ask for permissions

On purpose: Panegrip starts them with their own settings, never with Orca's skip-permissions default.

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.