ADE for working with a fleet of parallel agents
Go to file
Jinjing 90d0fae8f5
feat: add explicit worktree setup flow (#286)
* feat: add explicit worktree setup flow

- Centralize worktree activation setup flow

- fix: render orca.yaml file contents in settings repo pane instead of tags when using config file

- fix: command preview title for yaml configs

- fix: update UI copy and styling to better reflect yaml setup hooks

- fix: run setup hook in background if CLI worktree is created while GUI is closed

- fix: prevent duplicate terminal tab creation when creating worktrees from the UI

- fix: ensure CLI worktree create returns correct payload type and hooks up UI setup flow

- Squashed commits

- fix minor regression

- fix: close worktree context menu when deleting

- fix: keep delete dialog open while archive hook runs and support inline yaml scripts

- chore: fix lint, typecheck and react state mutations during render for setup script feature

* fix(lint): split worktrees.test.ts to stay under max-lines limit

Extract Windows path-handling tests into worktrees-windows.test.ts
to bring the original file under the 300-line oxlint max-lines rule.

* fix(test): set up path mocks for setup launch payload test

The computeWorktreePathMock and ensurePathWithinWorkspaceMock were
cleared by afterEach but not re-established in the test, causing
areWorktreePathsEqual to receive undefined and crash.
2026-04-03 23:44:23 -07:00
.agents/skills fix: prevent app crash on macOS reactivation by deduplicating IPC handlers (#81) 2026-03-23 23:44:12 -07:00
.claude/skills feat: extract file explorer entry filter logic (#200) 2026-03-29 13:16:43 -07:00
.github fix(ci): use github format for oxlint to show filenames in lint errors (#287) 2026-04-03 23:30:23 -07:00
.husky Replace eslint/prettier with oxlint/oxfmt, add pre-commit hooks 2026-03-16 20:38:27 -07:00
build Fix Windows build: generate proper ICO file instead of renamed PNG 2026-03-21 15:16:34 -07:00
docs feat: add explicit worktree setup flow (#286) 2026-04-03 23:44:23 -07:00
icon Fix Windows build: generate proper ICO file instead of renamed PNG 2026-03-21 15:16:34 -07:00
resources Fix Windows packaged Orca CLI launcher path resolution (#282) 2026-04-03 22:20:09 -07:00
scripts Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
skills/orca-cli Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
src feat: add explicit worktree setup flow (#286) 2026-04-03 23:44:23 -07:00
.editorconfig Initial commit 2026-03-16 20:29:24 -07:00
.gitignore fix: handle orphaned worktree deletion with disk cleanup (#109) 2026-03-25 23:14:48 -07:00
.npmrc remove npmmirror.com mirrors (missing arm64 dmg builder binary) 2026-03-19 01:52:53 -07:00
.oxfmtrc.json Replace eslint/prettier with oxlint/oxfmt, add pre-commit hooks 2026-03-16 20:38:27 -07:00
.oxlintrc.json Lint long files (and add TS skills) (#23) 2026-03-22 12:12:54 -07:00
AGENTS.md feat: show merge conflicts in source control sidebar (#204) 2026-03-29 15:40:23 -07:00
CLAUDE.md feat: show merge conflicts in source control sidebar (#204) 2026-03-29 15:40:23 -07:00
CONTRIBUTING.md docs: update README for CLI integration and improve conversion (#279) 2026-04-03 20:56:34 -07:00
LICENSE Add MIT license 2026-03-28 10:19:14 -07:00
README.md fix(mac): improve macOS release tagging (#284) 2026-04-03 23:07:44 -07:00
components.json Shadcn 2026-03-16 22:27:51 -07:00
debug_orca.png fix: use inline-flex to stabilize find widget buttons (#220) 2026-03-29 23:14:42 -07:00
dev-app-update.yml code release stuff 2026-03-19 00:36:36 -07:00
electron-builder.config.cjs Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
electron.vite.config.ts fix: extract path-security helpers, add tests, and improve type safety (#102) 2026-03-25 09:59:19 -07:00
file-drag.gif Update README screenshot to file-drag gif (#152) 2026-03-27 23:42:47 -07:00
package.json 1.0.82 2026-04-03 23:07:56 -07:00
pnpm-lock.yaml fix: preserve rich markdown round-trips (#267) 2026-04-03 09:57:54 -07:00
screenshot.png Add application screenshot to README (#12) 2026-03-21 17:09:18 -07:00
skills-lock.json Lint long files (and add TS skills) (#23) 2026-03-22 12:12:54 -07:00
tsconfig.cli.json Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
tsconfig.json Shadcn 2026-03-16 22:27:51 -07:00
tsconfig.node.json Major features 2026-03-17 01:40:24 -07:00
tsconfig.web.json Major features 2026-03-17 01:40:24 -07:00
vitest.config.ts Add PR checks workflow and Vitest coverage (#97) 2026-03-24 20:53:38 -07:00

README.md

Orca

Orca

GitHub stars Supported Platforms Follow on X

The cross-platform AI Orchestrator for 100x builders.
Available for macOS, Windows, and Linux.
Seamlessly manage multiple worktrees, run multiple AI agents concurrently, and track their progress.
Whether it's Claude Code, Codex, or OpenCode, Orca makes coordinating multiple features across multiple repos effortless.

Download at onOrca.dev

Orca Screenshot


Introducing the Orca CLI

Agent orchestration from your terminal.

Let your AI agent control your IDE. Programmatically add repos, spin up worktrees, and update status directly from the terminal. Ships with the Orca IDE (install under Settings).

npx skills add https://github.com/stablyai/orca --skill orca-cli

Quick Start: The First 60 Seconds

  1. Connect: Open Orca and connect your local Git repository.
  2. Isolate: Spin up a new worktree in one click (no more git stash).
  3. Automate: Open the built-in terminal, fire up your AI agent (like Claude Code), and let it work autonomously while you switch to another task.

Why Orca?

  • Zero-Friction Context Switching: Need to review an urgent PR while your agent builds a new feature? Spin up an isolated worktree instantly without messing up your local dev environment.
  • Agent Supervision: Stop babysitting terminals. Let multiple agents work autonomously across different repos while you monitor their status, logs, and unread notifications from a single dashboard.
  • Purpose-Built for AI Devs: Traditional IDEs aren't built for autonomous agents. Orca gives your AI the isolated environments, terminals, and programmatic control it needs to thrive.

Features that Supercharge your Workflow

  • Worktree Management: Spin up, manage, and switch between multiple Git worktrees instantly. Keep your context clean.
  • Agent-Ready Terminals: Robust support for multiple terminals, tabs, and panes. Run Claude Code, Codex, OpenCode, or your own agents side-by-side.
  • Smart Notifications & Status Tracking: See exactly which worktrees have active agents. Get worktree notifications and manually mark threads as unread (like Gmail ).
  • Deep GitHub Integration: Automatically track PRs, link GitHub issues (via the gh CLI), and view GitHub Actions checks right from your workspace.
  • Integrated Dev Tools: Built-in file editor, lightning-fast search, and a comprehensive source control tab to review diffs, make quick edits, and commit effortlessly.

Install

Get started today:


Community & Support

  • Twitter / X: Follow @orca_build for updates and announcements.
  • Feedback & Ideas: We ship fast. Missing something? Request a new feature.
  • Show Support: Star this repo to follow along with our daily ships.

Developing

Want to contribute or run locally? See our CONTRIBUTING.md guide.