Mobile companion

The Orca mobile companion is an iOS/Android app that pairs with your desktop Orca and gives you a read-mostly view of running agents — agent status, recent terminal scrollback, and the controls you actually want from a phone (replying to a prompt, sleeping a worktree, switching agent accounts). Pairing is one-time and the desktop is always the source of truth.

What you can do from mobile

• See every worktree, its agent, and its current status (working / done / waiting on input).
• Hydrate recent terminal scrollback so you can read what an agent did or asked.
• Select, copy, and paste text from the mobile terminal view — long-press to select, share-sheet to paste back into a reply.
• Send a short reply (continue, yes, free-text) when an agent is waiting on input.
• Switch your active agent account and see usage / rate-limit state on the go.
• Get push notifications when an agent finishes, mirroring desktop notifications.

The mobile app is intentionally not a full editor — it's a remote control for the desktop you already have running.

Pairing

1. On desktop, open Orca's pairing flow from the account / status menu. Orca shows a one-time pairing code.
2. On mobile, open the Orca companion app and choose Pair, then paste the code. (You can also follow a deep link from the desktop directly into the mobile pairing screen.)
3. The pairing exchange happens directly between desktop and phone; the resulting device token is stored in the phone's secure keychain.

Closing the desktop app drops the connection — there is no cloud relay. Reopen the desktop and the phone reconnects automatically.

Account switcher

The mobile app exposes the same account switcher as the desktop status bar, including inline usage for inactive accounts. Switching here switches on the paired desktop.

Troubleshooting

• Stuck spinner on a worktree — the phone tracks a heartbeat from the desktop agent process. If the desktop says idle but the phone shows working, force-refresh the worktree row to sync state.
• Pairing fails — make sure your desktop and phone are signed into the same Orca account. Pairing codes expire after a few minutes; generate a fresh one if it's been sitting on the screen.