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
| Feature | Works | Notes |
|---|---|---|
| Chats | Yes | Every agent in Orca's terminals |
| Questions and permissions | Yes | Answered from the phone |
| Terminal | Yes | The terminal's screen, with keys |
| New work | Yes | Worktrees, agents and terminals in Orca from the phone |
| Live replies | Yes | Words as the agent writes them |
| Forks and handoffs | Yes | Into a new Orca terminal |
Requirements
- A Mac with Orca
- An iPhone with Panegrip
Setup
Open Orca.
Install Orca and open it. Panegrip finds it by itself while it runs; there is nothing to connect.
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.
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.