Agent development environment · checked 2026-09-22

Orca ADE: parallel CLI agents, each in its own git worktree

Orca is not a model and it holds no keys: it puts CLI agents such as Claude Code, Codex and OpenCode each into their own git worktree and runs them at once, while model access still comes from your own subscription. What parallelism really saves, what you pay for it, and how each CLI's permission flags arrive pre-filled in Orca (checked 2026-09-22).

Updated 2026-09-22

#agent development environment#isolated git worktrees#any CLI agent#your own subscription

Four things to know

ADE

An ADE, not a model

The repo calls itself "Orca is the ADE for working with a fleet of parallel agents". The docs front page says "Orca is a desktop IDE for running multiple AI coding agents side by side" and adds "Not a model. Orca runs agents you already use". Both names cover one thing: the model is not part of it. Checked on 2026-09-22.

git worktree

Its own checkout per task

The README entry reads "Fan one prompt across five agents, each in its own isolated git worktree — compare the results and merge the winner". The docs give the mechanism: "every task gets its own on-disk copy of the repo via git worktree". The same page warns that a brand-new worktree is a clean checkout, so gitignored dependencies and secrets must be recreated. Checked on 2026-09-22.

any CLI agent

A picker, not a whitelist

The supported page is blunt: "Orca works with any CLI agent — the agent combobox just launches a process in a terminal". The table lists only what ships preconfigured in the built-in picker with one-click launch; deeper hooks, status, usage tracking and account switching are noted where supported. So this page gives no total count of agents. Checked on 2026-09-22.

not in real time

The usage bar reads local files

The docs say "Orca reads the local usage state each agent maintains on disk (under ~/.claude, ~/.codex, and the Gemini/OpenCode equivalents)", then "No API calls, no extra auth", and conclude "numbers update when the agent writes, not in real time". The page names Claude Code, Codex, Gemini, OpenCode, Kimi Code and MiniMax; we do not extend that to every agent. Checked on 2026-09-22.

What it is, and what it is not

The vendor describes one thing three ways, so all three at once: the repository page calls it the ADE for working with a fleet of parallel agents, the site expands the acronym to Agent Development Environment, the docs index page calls it a desktop IDE. Same product: several CLI agents side by side, each in its own git worktree, watched from one place. The negatives matter more. Not a model — the agents are ones you already subscribe to. Not hosted compute either: Orca does not sell managed VPS hosting, remote modes use machines and cloud accounts you control. Checked 2026-09-22.

The numbers this half year

No hype numbers, only values readable on the page that day. The data embedded in the GitHub repository page puts createdAt at 2026-03-17; the release carrying the Latest badge is v1.4.206 (2026-09-20). The README's first screen says free and open source under the MIT License, so installing it, reading it and filing issues costs nothing up front; the visible line on the site reads Free and open source. New features shipped daily. Spending starts on the agent side. Behind all the talk sit two vendor-backed facts: free and open source, and a cadence the vendor itself calls daily, with the README list perpetually behind. These values drift, so they stay here only as a 2026-09-22 snapshot.

Timeline

2026-03-17

2026-03-17: that is the createdAt the GitHub repository page reports for stablyai/orca (UTC). The same block says not a fork, organization-owned, not archived. Just over six months before this page's 2026-09-22 check.

2026-09-20

2026-09-20: v1.4.206 went out on GitHub Releases, and its notes say "It usually takes 48–72 hours for a landed PR to be released (except P0+ fixes)". The README admits "we ship daily, so this list is perpetually behind". The install docs put a limit on that claim: auto-update tracks the stable channel, stable releases are vetted, and the RC builds are the ones shipping new features, often daily. Checked on 2026-09-22.

2026-09-22

2026-09-22: every official sentence quoted in these four languages was captured that day from the README, the official docs and GitHub Releases and compared word for word. Counters that move minute to minute — stars, forks — are not quoted in the body: the number would go stale the same day it was written. Checked 2026-09-22.

Verbatim in the docs vs traps

Verbatim in the docs

Checked 2026-09-22. Verbatim on official pages: Not a model. Orca runs agents you already use; Orca does not sell managed VPS hosting; Orca is worktree-native, so each task gets its own on-disk copy of the repo rather than branching and stashing; Orca works with any CLI agent, since the combobox just launches a process in a terminal — though picker entries are preconfigured for one-click launch, with deeper hooks, status, usage tracking and account switching noted only where supported. The usage bar reads local state each agent keeps on disk: No API calls, no extra auth, and numbers update when the agent writes, not in real time. Install is one command, brew install --cask stablyai/orca/orca, and on Linux the CLI lands as orca-ide. License: free and open source under the MIT License.

⚠️ Namesakes and drift

Two easy misses. Namesakes: searching for orca first hits Plotly's chart export tool, whose README says Orca has been deprecated as of August 2026 and points at Kaleido; the bare orca cask in Homebrew describes that same tool (interactive plotly charts), and it has been disabled since 2026-09-01 — today it refuses to install, it does not silently install the wrong thing. On GNOME desktops /usr/bin/orca belongs to the screen reader, which is why the CLI installs as orca-ide and the docs say Do not verify with command -v orca. Drift: at the end of its feature list the README writes we ship daily, so this list is perpetually behind, and the changelog link named there goes to GitHub Releases, not to the site's own changelog. The Install docs narrow the tempo to Stable releases are vetted, leaving the daily claim about RC builds — nobody wrote «a stable build every day». Checked 2026-09-22.

Against N terminals plus tmux

What it adds

Four things the docs state verbatim and a bare terminal makes you build: a separate on-disk repo copy per task; one prompt fanned out to several agents, then compared and the winner merged; a usage bar reading local bookkeeping instead of asking the vendor; a phone companion with finish notifications and follow-ups. Checked 2026-09-22.

What you give up

The other side belongs on the page too. A brand-new worktree is a clean checkout: gitignored dependencies, caches and local secrets stay missing until you recreate them. Agents started in parallel get each CLI's permission-bypass flag pre-filled; the docs stop at that pre-fill. Orchestration needs the Experimental switch in Settings, and the docs state Command flags evolve with the app. The phone is read-mostly; the desktop is the source of truth. With N terminals and tmux all that stays in your hands — readable, auditable, versionable scripts — at the cost of building the isolation and the usage view yourself. Checked 2026-09-22.

How to install it, and the first run

1) macOS: use the tapped brew install --cask stablyai/orca/orca. It tracks stable; brew upgrade --cask orca pulls new builds. Untapped, brew install --cask orca hits Plotly's chart exporter, disabled in Homebrew since 2026-09-01, so it fails instead of installing the wrong app. 2) Install covers macOS, Windows and Linux; each stable release ships AppImage, .deb and .rpm. Only the AppImage self-updates, the rest give a Copy Install Command. 3) Arch takes yay -S stably-orca-bin from the README; repackaged AUR or Nix installs get no in-app update. 4) On Linux the CLI installs as orca-ide, since /usr/bin/orca belongs to the GNOME screen reader, and the docs say do not verify with command -v orca. Then run one tiny task in a new worktree: a brand-new worktree is a clean checkout, so gitignored dependencies, caches and secrets are absent (checked 2026-09-22).

One bridge to QCode, no more

Orca proxies no models and stores no credentials of yours: the official first-session page says Orca will launch the agent's CLI with the correct working directory and forward your subscription credentials. Endpoints and keys are therefore set inside that launched CLI's own config, and the key it ends up using can be a QCode one — that is the only bridge on this page. Orca is a local app and is not in our model list, so this page never says it supports QCode and makes no availability promise. Pointing Claude Code at another base_url is on /anthropic-base-url-setup-guide, with no repeat of those two variables here; per-agent endpoint fields are on /orca-third-party-api-key. Its usage bar reads what each agent writes to local disk and the docs defer to the provider console, so do not reconcile against it (checked 2026-09-22).

FAQ

Do I need a Claude or Codex subscription before Orca?

Orca itself is free: the README says Orca is free and open source under the MIT License. It also does not sell model access — the What is Orca page says Orca runs agents you already use — bring your own Claude, Codex, or OpenCode subscription, and its When to use Orca list opens with You already pay for Claude Code, Codex, or Cursor CLI. The GLM page states verbatim: Orca does not include or resell GLM access. The money sits with that agent's subscription or credentials, not with Orca (checked 2026-09-22).

Can I point it at my own key or endpoint?

Not inside Orca. The official first-session page says Orca will launch the agent's CLI with the correct working directory and forward your subscription credentials, and the supported page spells out the mechanism: the agent combobox just launches a process in a terminal. Key and endpoint edits therefore happen in that CLI's own config. The one model switch on the Orca side is --model in orchestration, which the docs limit to opaque provider model IDs for Claude, Codex, and Cursor; every other agent goes back to its own config. Field-by-field wording is on /orca-third-party-api-key (checked 2026-09-22).

Why doesn't its usage bar show OpenRouter or another gateway?

Two limits stack up. Coverage: the official usage-tracking page names only Claude Code, Codex, Gemini, OpenCode, Kimi Code, and MiniMax — those 6 — and the supported page says deeper hooks, status, usage tracking, and account switching are noted where supported, so coverage is not uniform. Freshness: the same page says numbers update when the agent writes, not in real time. Whether the bar stays accurate after you point an agent at a third-party endpoint such as OpenRouter is not written in the official docs, and this page does not guess for them (checked 2026-09-22).

How far does the phone app go?

You can watch and steer, but it is not a second client. The README says Monitor and steer your agents from your phone, and the mobile page bounds that: gives you a read-mostly view of running agents — agent status, recent terminal scrollback, plus replying to a prompt, sleeping a worktree, reviewing source control and switching agent accounts. Same page: Pairing is one-time and the desktop is always the source of truth, and The mobile companion is in beta. Codex rate-limit reset credits can be spent from the companion's Accounts screen (checked 2026-09-22).

An SSH worktree refuses to connect — what first?

The official ssh page names two blockers. 1) Host key verification: Orca checks built-in SSH connections against your effective OpenSSH known_hosts files and keys it saved before; a rebuilt or reprovisioned host with a new fingerprint is rejected before Orca asks for a password, so verify the fingerprint yourself first, and on a known_hosts mismatch it hands you the matching ssh-keygen -R command. 2) Remote build chain: the first connect installs a small relay on the host, which on Linux often compiles node-pty on the spot, so a machine without make, a C++ compiler and python3 still gets files, git and the editor while remote terminals stay broken until you install the tools and reconnect (checked 2026-09-22).

Does it call models or rack up bills on its own?

Not on the usage side: the official wording is No API calls, no extra auth — it only reads the bookkeeping each agent writes to local disk. What calls models and costs money is the launched CLI, and the same docs warn twice: For new launches, Orca pre-fills each supported CLI's permission-bypass flag, and A worktree is an isolated checkout, not a security sandbox. The official countermeasure is choosing Manual under Settings → Agents → Agent Permissions. Orca adds no model proxy layer, since the supported page says the agent combobox just launches a process in a terminal (checked 2026-09-22).

Sources

Official repository and README: https://github.com/stablyai/orca and https://raw.githubusercontent.com/stablyai/orca/main/README.md. Official docs: https://www.onorca.dev/docs, and the pages quoted verbatim here are install, model/worktrees, ssh, mobile, agents/supported, agents/usage-tracking, agents/glm-agent, cli/orchestration and first-session (raw sources under https://raw.githubusercontent.com/stablyai/orca/main/docs/site/content/docs/). Same-name checks: https://formulae.brew.sh/cask/orca and https://orca.gnome.org/. All captured 2026-09-22. The README itself says we ship daily, so this list is perpetually behind, so command names, package names and the agent list are bounded by that date.

Get the key and the quota straight first

This page is about Orca, a local app the official docs describe as a desktop IDE. It ships no models: model access comes from the configuration of the agent it launches, and that key can be a QCode one. Official wording checked 2026-09-22.

Related reading

This page paraphrases the Orca documentation and repository that Stably publishes in the open. We are not affiliated with Orca or Stably and hold no endorsement from them. Command names, package names, the agent list and the behaviour of the usage bar are bounded by the official pages captured on 2026-09-22, and the official README itself says its feature list is perpetually behind, so recheck upstream before installing. QCode is only one possible provider of the key the launched agent uses and is not responsible for Orca's behaviour.