A paired desktop advertised no structured capability, so a host withheld every structured session-tab row from it and refused the whole agentSession.* surface. A user with two machines could see a chat on one of them only. This advertises the reader: structured, claude-structured, the turn item and the status feed. Deliberately not hold, reveal or resume-history — an adjunct says the renderer can answer for it, and those three are the surfaces that write. Mobile already drives desktop-hosted structured sessions over this same surface, so the host's admission, projection and multi-subscriber paths are production-exercised; what is new is this client's list and the desktop's consumption of the rows it now receives. Advertising is not dormant. Against a capable host it restores and publishes sessions that already existed, and a pane over one of those would take a hold — which opens the durable record on the other machine and hands its session a provider child back. The host does not stop it: the hold is gated on the reader string, not on the hold string this client withholds. So the pane refuses itself. An environment-owned session renders through the owner-bound pane with every mutation off and no hold call made at all, under its own notice rather than one of the hold states, because nothing here was refused and nothing is missing on the host. The retreat is a client setting, structuredChatRemoteRead, distinct from the host's own structured-chat admission switch. Off, this desktop stops advertising the reader and a host withholds the rows again, from each pairing's next connection. Every call site that opens a paired connection now reads the list through one place, and a test fails if a new one reads the constant instead. Wire: new client capability advertisement and changed published content with no codec change. Cross-version journeys run both directions against a real release — this desktop's own advertised list, read from the shipped constant, against an old host and a new one, and a desktop derived without the advertisement against both, on the same host and the same socket.
Orca
中文 · 日本語 · 한국어 · Español · Français · Português
The AI Orchestrator for 100x builders.
Run Codex, ClaudeCode, OpenCode or Pi side-by-side — each in its own worktree, tracked in one place.
Download Orca
Features
Also in the box:
- Quick open — Search across worktrees, files, agents, commands, and repo context without leaving your flow.
- Account switcher & usage tracking — See Claude and Codex usage and rate-limit resets, and hot-swap accounts without re-logging in.
- Rich repo previews — Preview Markdown, images, PDFs, and repo docs in the workspace.
- Computer Use — Let agents operate desktop apps and visible UI when a workflow needs real interaction.
- Notifications and unread state — Know when an agent finishes or needs attention, then mark threads unread to come back later.
- And many, many more — we ship daily, so this list is perpetually behind. The changelog is the real feature list.
Supported Agents
Works with any CLI agent — if it runs in a terminal, it runs in Orca.
Claude Code
Codex
Grok
Cursor
GitHub Copilot
OpenCode
MiMo Code
Amp
OpenClaude
Antigravity
Pi
oh-my-pi
Hermes Agent
Devin
Goose
Auggie
Autohand Code
Charm
Cline
Codebuff
Command Code
Continue
Droid
Kilocode
Kimi
Kiro
Mistral Vibe
Qwen Code
Rovo Dev
+ any CLI agent
Install
Desktop — macOS, Windows, Linux
- Download from onOrca.dev
- Or grab a build directly: macOS Apple Silicon · macOS Intel · Windows (.exe) · Linux AppImage · All builds
- Running
orca serveon a headless Linux server? See the headless Linux server guide.
Or via a package manager:
# macOS (Homebrew)
brew install --cask stablyai/orca/orca
# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-bin
Mobile Companion — iOS, Android
Pair with your desktop app to monitor and steer your agents from your phone.
- iOS: Download on the App Store or join TestFlight
- Android: Download APK 0.0.48 · Install guide
Community & Support
-
Discord: Join the community on Discord.
-
Twitter / X: Follow @orca_build for updates and announcements.
-
WeChat: Scan to join the Orca community WeChat group 8. Group 8 may be full; if so, scan the Group 9 QR code instead.
-
Feedback & Ideas: We ship fast. Missing something? Request a new feature.
-
Privacy: See the privacy & telemetry docs for what anonymous usage data Orca collects and how to opt out.
-
Show Support: Star this repo to follow along with our daily ships.
Developing
Want to contribute or run locally? See our CONTRIBUTING.md guide.
The relay that pairs the mobile app with a desktop host is also in this repository under
cloud/, with a separate pnpm workspace and setup guide.
Signed Builds
Windows code signing sponored/provided by SignPath.io, certificate by SignPath Foundation.
License
Orca is free and open source under the MIT License.












