ADE for working with a fleet of parallel agents
Go to file
Benny Jiang 6ba4bf4fd4
fix: don't spawn Codex in the background when signed out (#4593)
The rate-limit quota poller fetches Codex usage on app start, window
focus, and every poll. Unlike the Claude and Gemini fetchers (which read
credentials from files/keychain and hit an HTTP endpoint), the Codex
fetcher always spawns the real codex binary — 'codex app-server' over
RPC, and on RPC failure an interactive codex PTY running /status.

For users who have Codex installed but never signed in, this surfaces as
an unexpected Codex process starting in the background even though they
never launched Codex. The spawn can only fail without auth.

Gate the fetch on the presence of Codex auth (auth.json under the
resolved CODEX_HOME / managed-account home). When absent, return
status 'unavailable' without spawning anything, mirroring how the other
providers stay quiet until configured. Signed-in users are unaffected.
2026-06-03 20:10:51 -04:00
.github Update CONTRIBUTING.md 2026-06-01 23:38:15 -07:00
.husky
Casks release: add Homebrew RC cask channel (#3462) 2026-05-29 22:34:44 -07:00
config Fix macOS helper path and token cleanup (#3961) 2026-06-03 16:59:02 -04:00
docs Simplify project add handoff (#4530) 2026-06-03 16:50:35 -07:00
mobile added horizontal screen support (#4316) 2026-06-03 19:08:41 -04:00
native Fix macOS keyboard actions targeting the wrong app (#3960) 2026-06-03 19:00:34 -04:00
resources fix: trim small macOS app icon slots (#3896) 2026-05-30 13:09:15 -07:00
skills Update Orca CLI skills for agent worktree flow (#4529) 2026-06-03 16:45:34 -07:00
src fix: don't spawn Codex in the background when signed out (#4593) 2026-06-03 20:10:51 -04:00
tests Simplify project add handoff (#4530) 2026-06-03 16:50:35 -07:00
tools/spikes
.env.e2e
.gitignore Ignore local React perf audit ledger (#3417) 2026-05-29 19:09:42 -07:00
.npmrc fix: update Electron and revert UTF-8 write mitigations (#4598) 2026-06-03 16:45:01 -07:00
.oxfmtrc.json
.oxlintrc.json Adjust max-lines lint budgets (#4515) 2026-06-02 15:22:17 -07:00
AGENTS.md Adjust max-lines lint budgets (#4515) 2026-06-02 15:22:17 -07:00
CLAUDE.md
LICENSE
README.md Update mobile 0.0.11 release links (#4440) 2026-06-01 21:42:38 -07:00
components.json
electron.vite.config.ts Add early macOS startup diagnostics (#4504) 2026-06-02 14:02:19 -07:00
orca.yaml Fix Windows setup hook script (#2106) 2026-05-16 17:44:42 -04:00
package.json release: v1.4.42-rc.8 2026-06-03 23:47:39 +00:00
pnpm-lock.yaml fix: update Electron and revert UTF-8 write mitigations (#4598) 2026-06-03 16:45:01 -07:00
tsconfig.json
vite.web.config.ts Update onboarding feature wall experience (#2652) 2026-05-23 12:21:13 -07:00

README.md

Orca Orca

Supported Platforms Discord Follow on X

English · 中文 · 日本語 · 한국어 · Español

The AI Orchestrator for 100x builders.
Run Claude Code, OpenClaude, Codex, Grok, Antigravity, or OpenCode side-by-side across repos — each in its own worktree, tracked in one place.
Available for macOS, Windows, and Linux.

Download 🐋

Orca worktree IDE demo showing Claude Code, Codex, and OpenCode running in parallel across isolated git worktrees

Supported Agents

Orca supports any CLI agent (not just this list).

Claude Code   OpenClaude   Codex   Grok   Gemini   Antigravity   Pi   oh-my-pi   Hermes Agent   OpenCode   Goose   Amp   Auggie   Autohand Code   Charm   Cline   Codebuff   Command Code   Continue   Cursor   Droid   GitHub Copilot   Kilocode   Kimi   Kiro   Mistral Vibe   Qwen Code   Rovo Dev


Features

  • No login required — Bring your own Claude Code, OpenClaude, Codex, Grok, or Antigravity subscription.
  • Worktree-native — Every feature gets its own worktree. No stashing, no branch juggling. Spin up and switch instantly.
  • Multi-agent terminals — Run multiple AI agents side-by-side in tabs and panes. See which ones are active at a glance.
  • Built-in source control — Review AI-generated diffs, make quick edits, and commit without leaving Orca.
  • GitHub integration — PRs, issues, and Actions checks linked to each worktree automatically.
  • SSH support — Connect to remote machines and run agents on them directly from Orca.
  • Notifications — Know when an agent finishes or needs attention. Mark threads unread to come back later.

Install

Mac, Linux, Windows

Alternatively, install from a package manager:

macOS (Homebrew)

brew install --cask stablyai/orca/orca

Arch Linux (AUR)

# Precompiled binary
yay -S stably-orca-bin

# Build from GitHub source
yay -S stably-orca-git

Mobile Companion App

Control your agents from your phone.

Orca desktop with the mobile companion app


Feature Showcase

Click any tile to explore the workflow.

Parallel Worktrees

Parallel worktree orchestration
   Terminal Splits

Ghostty-class terminal splits


Design Mode

Embedded browser and Design Mode
   GitHub & Linear, Native

GitHub and Linear task workflows in Orca


Every CLI Agent

Works with every CLI agent
   SSH Worktrees

Remote worktrees over SSH


Drag Files to Agents

Drag files and images into an agent prompt
   Annotate AI Diffs

Annotate AI-generated diffs


Orca CLI

Script Orca from the CLI
   Native Search

Native search across Orca workflows


Account Switcher & Usage Tracking

Account switching and usage tracking
   Rich Repo Previews

Markdown, images, PDFs, and repo document previews


Split Anything

Split panes for agents, terminals, browsers, and files


Community & Support

  • Discord: Join the community on Discord.
  • Twitter / X: Follow @orca_build for updates and announcements.
  • 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.