ADE for working with a fleet of parallel agents
Go to file
Neil 1be13d58f3
fix(daemon): defer startup flush past shell raw-mode switch (#1060)
* fix(daemon): defer startup-command flush past shell raw-mode switch

When launching an agent (e.g. `claude`) through the quick-launch menu,
the command name appeared twice in the terminal — once from kernel
echo, once from readline's prompt redraw. The daemon session was
flushing its pre-ready stdin queue the moment the OSC 777 shell-ready
marker arrived, but that marker fires from precmd_functions /
PROMPT_COMMAND — before the shell draws its prompt and before
zle/readline flips the PTY into raw mode. Writing while ECHO was still
on produced the visible duplicate.

Mirror the gating already used by the non-daemon path
(local-pty-shell-ready.ts::writeStartupCommandWhenShellReady): wait
for the next data chunk after the marker (the prompt draw) plus a
short 30ms delay, with a 50ms wall-clock fallback for the case where
the prompt arrives in the same chunk as the marker.

This regression became visible after #1025 made the shell-ready
wrappers persist reliably — previously the marker was often missed
and the 15s fallback path fired long after the shell was already in
raw mode, masking the race.

* refactor(daemon): extract PostReadyFlushGate out of Session

Factor the post-ready flush gating out of Session into its own class in
post-ready-flush-gate.ts. Session's only responsibility is now to
arm() the gate on shell-ready, notifyData() on subsequent PTY data,
and clear() on teardown. Removes the max-lines oxlint-disable added in
the previous commit and puts the timing behavior behind focused unit
tests.

No behavior change — kept as a separate refactor commit from the
behavior fix for reviewability.

* fix(daemon): keep queueing writes while post-ready flush gate is pending

Codex review caught an ordering regression: once transitionToReady()
sets _shellState to 'ready', any Session.write() that arrives during
the 30–50ms gate window was being written directly to the subprocess,
bypassing the still-unflushed preReadyStdinQueue. That let late input
race ahead of the buffered startup command.

Expose PostReadyFlushGate.isPending and continue queuing while the gate
is armed so queued writes drain in their original order before any
fresh input reaches the subprocess.
2026-04-24 15:26:50 -07:00
.agents/skills docs(electron-skill): harden playwright-cli usage against alias and port collisions (#996) 2026-04-23 10:14:42 -07:00
.claude/skills feat(editor): preserve Cmd+B for bold in markdown editor (#802) 2026-04-18 10:08:25 -07:00
.github Add community PRs directly to project (#1052) 2026-04-24 13:50:10 -07:00
.husky
config fix terminal resize flicker during pane drag (#962) 2026-04-22 17:50:14 -07:00
docs Rename add repo copy to add project (#1014) 2026-04-23 19:02:36 -07:00
patches fix: resolve posix_spawnp failure in daemon's node-pty spawn (#762) 2026-04-17 10:37:56 -07:00
resources Revert "fix(terminal): terminal mic access" (#1057) 2026-04-24 14:44:21 -07:00
scripts feat: Add SSH remote support (beta) (#590) 2026-04-13 19:23:09 -07:00
skills/orca-cli feat(cli): add terminal create, split, rename, focus, close, tui-idle wait (#734) 2026-04-22 17:51:32 -07:00
src fix(daemon): defer startup flush past shell raw-mode switch (#1060) 2026-04-24 15:26:50 -07:00
tests feat(terminals): per-tab activity indicators (#944) 2026-04-24 14:05:09 -07:00
.editorconfig
.env.e2e feat: add idempotent E2E test suite with headless Electron support (#671) 2026-04-19 12:09:32 -07:00
.gitignore diff-comments: copy-only flow in Source Control (#884) 2026-04-20 21:50:31 -07:00
.npmrc min release age = 1 day 2026-04-06 23:32:45 -07:00
.oxfmtrc.json
.oxlintrc.json Lint long files (and add TS skills) (#23) 2026-03-22 12:12:54 -07:00
AGENTS.md docs(agents): tighten code-comment rule to short, why-only (#883) 2026-04-20 19:39:25 -07:00
CLAUDE.md feat: show merge conflicts in source control sidebar (#204) 2026-03-29 15:40:23 -07:00
CONTRIBUTING.md chore(release): expose patch/minor/major as Cut Release kinds (#999) 2026-04-23 11:11:46 -07:00
LICENSE Add MIT license 2026-03-28 10:19:14 -07:00
README.md Rename add repo copy to add project (#1014) 2026-04-23 19:02:36 -07:00
components.json
dev-app-update.yml
electron.vite.config.ts fix: bundle xterm deps into daemon-entry to fix packaged build crash (#759) 2026-04-17 09:29:29 -07:00
orca.yaml Add orca.yaml with setup script (#685) 2026-04-15 19:01:08 -07:00
package.json release: 1.3.17-rc.4 [rc-slot:2026-04-24-15] 2026-04-24 22:11:56 +00:00
pnpm-lock.yaml feat: add Linear integration (#1007) 2026-04-23 14:54:32 -07:00
skills-lock.json Lint long files (and add TS skills) (#23) 2026-03-22 12:12:54 -07:00
tsconfig.json feat: Add SSH remote support (beta) (#590) 2026-04-13 19:23:09 -07:00
vitest.config.ts fix: harden terminal pane lifecycle for split groups (#641) 2026-04-14 16:23:01 -07:00

README.md

Orca

Orca

Supported Platforms Discord Follow on X

English · 中文 · 日本語

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

Download at onOrca.dev

Orca Screenshot

Supported Agents

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

Claude Code   Codex   Gemini   Pi   Hermes Agent   OpenCode   Goose   Amp   Auggie   Charm   Cline   Codebuff   Continue   Cursor   Droid   GitHub Copilot   Kilocode   Kimi   Kiro   Mistral Vibe   Qwen Code   Rovo Dev


Features

  • No login required — Bring your own Claude Code or Codex 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.
  • Notifications — Know when an agent finishes or needs attention. Mark threads unread to come back later.

Install


[New] Hot Swap Codex Accounts

Multiple Codex accounts? Switch in one click.

If you run multiple Codex accounts to get the best token deal, Orca lets you hot-swap between them instantly — no re-login, no config files. Just pick an account and keep building.

Orca Codex Account Switcher — hot swap between multiple Codex accounts


[New] Per Worktree Browser & Design Mode

See your app. Click any element. Drop it into the chat.

Orca ships with a built-in browser right inside your worktree. Preview your app as you build, then switch to Design Mode — click any UI element and it lands directly in your AI chat as context. No screenshots, no copy-pasting selectors. Just point at what you want to change and tell the agent what to do.

Orca Design Mode — click any UI element and drop it into the chat


[New] Introducing the Orca CLI

Agent orchestration from your terminal.

Let your AI agent control your IDE. Use AI to add projects to your IDE, spin up worktrees, and update the current worktree's comment with meaningful progress checkpoints directly from the terminal. Ships with the Orca IDE (install under Settings).

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

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.
  • Show Support: Star this repo to follow along with our daily ships.

Developing

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