Brennan Benson 21c34900f9 fix(notes): keep idle agents selectable in Send notes to, never send into approval menus (#42239)
* fix(notes): keep idle terminal agents selectable in Send notes to

An idle agent sends no status events, so after 30 minutes (or right after a
restart) Send notes to greyed out live panes as 'Agent status is stale' for
every agent without an explicit idle title (Kiro, jcode, ...). Treat a pane
with an agent row and a live PTY binding as selectable regardless of row age;
the host's process/screen check still gates the send. Keep an unanswered
permission prompt disabled at any age unless a live title shows it cleared.

* fix(notes): keep permission evidence pane-scoped in Send notes to

An unanswered permission prompt now disables its pane until the agent
reports again, at any age; an idle-looking title no longer clears it,
since Claude keeps its idle glyph while a dialog is open. A tab title is
used as a pane's live title only when the tab is not split, so a split
sibling's title never speaks for another pane. Target derivation no
longer takes the current time.

* test(notes): complete the status-entry fixture

* test(notes): use current agent rows for idle send targets

* test(notes): exercise expired agent status rows

* fix(notes): never send notes into an agent's approval menu

"Send notes to" now keeps live agents selectable at any idle age, so it must never press Enter on an approval menu the host cannot see. Kiro, Amp, Command Code and Cursor keep reporting "working" from their hooks while an approval waits for a key, and the host treated that as sendable (main already did so for the first 30 minutes).

- The host recognises Kiro's approval menus on screen (rules ported from the common pattern's Kiro screen rules), so a send refuses with "needs permission" while one is up.
- A mid-turn agent whose hooks hide approvals and whose screen rules can't see them (Amp, Command Code today) is refused with "may be waiting for approval"; idle agents are unaffected. Adding a screen rule for such an agent lifts this automatically.
- Older paired hosts can't do either, so on hosts without the new terminal.send-approval-guard capability "Send notes to" disables those agents' mid-turn rows with the same reason.

Tracked in STA-15222.

* fix(notes): refuse mid-turn sends to agents whose hooks hide approvals

Both reviewers showed a screen rule can't prove an agent has no approval menu up: Cursor's file approvals and Kiro's question panel and wrapped footers slip past, and the rules made the wait-text rebuild hot. Drop the Kiro rules and the host capability. A Kiro, Amp, Command Code or Cursor pane is sendable only when that agent's own latest report ended its turn; mid-turn, or with no report at all, both the host guard and Send notes to refuse with "may be waiting for approval". The same rule on both sides works with older hosts without a capability check, and a title can no longer clear the refusal.

Tracked in STA-15222.

* fix(notes): check the running agent before trusting a pane's report

Review pass 2: the host trusted a row another agent left on the pane and missed shell-launched agents with no cached identity; a newer client on an older host could still reach Enter after a turn started. The guard now reads the pane's foreground agent (falling back to launch identity), ignores rows from another agent or terminal, and the client refuses a working report from a hook-silent agent before paste and before Enter.

Tracked in STA-15222.

* fix(notes): name a wrapped agent by its title before allowing a send

Review pass 3: an agent behind a wrapper such as node, with no hook row or launch identity, read as no agent at all, so the host guard and the client's older-host check let a send through. Both now fall back to the agent the terminal title names.

Tracked in STA-15222.

* fix(notes): don't let another agent's row vouch for a launched Kiro, Amp, Command Code or Cursor

Review pass 3: a newer client on an older host trusted a Claude row left on a pane that now runs a launch-owned hook-silent agent. The listing and the client's agent lookup now treat that pane as the launched agent.

Tracked in STA-15222.

* fix(notes): refuse hook-silent agents on hosts without the send guard

Council ruling (2 of 3, option B) after review pass 3. An older paired host has no guard between the client's last check and the Enter write, so the client can't make a send to Kiro, Cursor, Amp or Command Code safe there. New hosts advertise terminal.send-approval-guard.v1; on hosts without it "Send notes to" disables those agents with "Update Orca on this host to send to this agent" and the send refuses before any write. This replaces the client's working-status check.

Identity is per pane: the agent's own row, the tab's launch agent only on the launch PTY, or the leaf's own title; any of them naming a hook-silent agent counts, so a row another agent left behind can't vouch for it and a split sibling isn't refused for the launch agent. The renderer reads the guard as a stable set of host ids, so unrelated host-status updates don't rescan targets.

Tracked in STA-15222.

* test(notes): build send-target fixtures from accepted status rows

* fix(notes): keep the hook-silent send guard in its own runtime layer

check:changed: the guard pushed terminal-agent-status-and-submission.ts over the file-length limit, a test concatenated strings, and a fixture read the wall clock.

* fix(notes): refuse when pane identities disagree about a hook-silent agent

Review threads: a stale launch identity, a row from another hook-silent agent, or a split sibling borrowing the tab's launch agent could let the host guard or the target list trust the wrong turn-end report. One shared rule now decides for both: every identity the pane has counts, a send needs exactly one hook-silent agent whose own latest report ended its turn, and launchAgent only names the tab's original PTY.

Tracked in STA-15222.

* fix(notes): treat any paired pane as the launched agent's and cache host guard reads

Review pass 4: a paired tab's ptyId follows its active pane, so tying launchAgent to it could drop a launched Kiro's identity on an older host; on paired panes the launch agent now counts for every pane (safe direction). The guard-host set is cached by status-map identity, the host guard also matches rows keyed only by terminal handle, and a focused pane without a leaf binding is checked against the tab's PTY instead of skipped.

Tracked in STA-15222.
2026-11-16 22:46:18 -08:00
2026-11-15 03:48:34 +00:00
2026-03-16 22:27:51 -07:00
2026-03-28 10:19:14 -07:00

Orca Orca

GitHub stars Total downloads across all releases License: MIT Join the Orca Discord Follow Orca on X Supported platforms: macOS, Windows, and Linux

中文 · 日本語 · 한국어 · Español · Français · Português · Türkçe · Русский

The AI Orchestrator for 100x builders.
Run Claude Code, Codex, and any other coding agent in parallel, each in its own worktree. Chat or terminal, on your laptop or in the cloud, with diffs, a browser, and a CLI in one app.

Download Orca

Orca desktop app with a coordinator agent running worker agents in parallel workspaces, and the Orca mobile app in the corner

Features

Chat or Terminal

Run any agent in Chat UI or as the raw CLI, and move a conversation between the two without losing context.

Docs →

The same agent conversation in Chat UI and in the terminal, side by side

Orchestrate Agents

Hand a big task to one agent. It splits the work, starts worker agents in their own workspaces, and brings their results back to you.

Docs →

A coordinator agent splitting a task between two worker agents and reporting their results

Run Anywhere

Pair a Remote Orca Server, work on any SSH host, or give a worktree its own cloud VM. Your agents keep running when your laptop sleeps.

Docs →

Choosing which machine a new worktree runs on, from this computer to an SSH host or a per-workspace environment

Mobile App

Pair Orca with the mobile app to get pinged when an agent needs you, reply in chat, and keep work moving on any of your machines when you are away from your desk.

iOS App Store · Google Play · Android APK · Docs →

The Orca mobile app getting a notification that Claude needs input, opening the session, and replying so the agent opens the PR

Review AI Output

Review diffs, leave notes on exact changed lines, and send focused feedback back to an agent.

Docs →

A note on a changed diff line sent back to the agent

Git Integration

Draft commit messages and pull requests from the diff, then send failing checks or PR review comments back to an agent to fix.

Docs →

Drafting a commit and pull request, then sending a review comment back to the agent

Parallel Worktrees

Quickly split tasks into isolated environments, so multiple agents can work side by side without interfering with each other.

Docs →

Creating a new worktree with its own agent next to other running worktrees

Design Mode

Click any element in Orca's browser to copy its HTML, styles, and selector, then paste it into your agent's chat.

Docs →

Picking a button in Orca's browser and sending it to the agent's chat

GitHub & Linear, Native

See your GitHub and Linear tasks in one place, and start a workspace for each when you're ready to build.

Docs →

GitHub and Linear issues in Orca, with a workspace started from a Linear issue

Orca CLI

Anything you can do in Orca, your agents can do too: create worktrees, start workers, drive the browser and desktop apps, and schedule automations, all from the command line.

Docs →

An agent running orca worktree create to start a worker in a new worktree

Plugins

Themes, editors, languages, and panels from the community, installed in a click.

Browse plugins →

Installing the Orca Midnight theme from the plugin catalog

Split Anything

Put agents, terminals, browsers, and diffs side by side in split panes shaped to the task.

Docs →

Dragging tabs into split panes with an agent, browser, terminal, and diff

Also in the box:

  • Drag Files to Agents: drag files from the explorer, or images from your desktop, straight into an agent's prompt.
  • Jump Anywhere: one shortcut jumps to any workspace or tab across every repo and host.
  • Rich Previews: open images, PDFs, and Markdown right in the workspace, next to the agent that made them.
  • Mobile Emulator: run an iOS Simulator or Android emulator beside your agent, and let it tap, type, and check its own work.
  • Dictation: press a shortcut and talk. Orca types what you say into the agent's prompt or terminal.
  • Usage & Accounts: see how much of your agent limits you've used and when they reset, and switch accounts without logging out.
  • Automations: schedule prompts to run on any repo: nightly dependency bumps, weekly triage, flaky-test sweeps.
  • Computer Use: when there's no CLI or API, agents can see and drive desktop apps and external browsers.
  • 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 logo Claude Code   Codex logo Codex   Grok logo Grok   Cursor logo Cursor   GitHub Copilot logo GitHub Copilot   Muse logo Muse   DeepSeek Harness logo DeepSeek Harness   ZCode logo ZCode   OpenCode logo OpenCode   MiMo Code logo MiMo Code   Amp logo Amp   OpenClaude logo OpenClaude   Antigravity logo Antigravity   Pi logo Pi   oh-my-pi logo oh-my-pi   Hermes Agent logo Hermes Agent   Devin logo Devin   Goose logo Goose   Auggie logo Auggie   Autohand Code logo Autohand Code   Charm logo Charm   Cline logo Cline   CodeBuddy logo CodeBuddy   Codebuff logo Codebuff   Freebuff logo Freebuff   Command Code logo Command Code   Continue logo Continue   Droid logo Droid   Kilocode logo Kilocode   Kimi logo Kimi   Kiro logo Kiro   Mistral Vibe logo Mistral Vibe   Qwen Code logo Qwen Code   Rovo Dev logo Rovo Dev   + any CLI agent


Install

Desktop — macOS, Windows, Linux

Or via a package manager:

# macOS (Homebrew)
# Always use the full name; bare `orca` is an unrelated Plotly cask.
brew install --cask stablyai/orca/orca
# Upgrade an existing install
brew upgrade --cask stablyai/orca/orca
# Release candidates (conflicts with the stable cask; uninstall it first)
brew install --cask stablyai/orca/orca@rc

# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-bin

Mobile App — iOS, Android

Pair with your desktop app to monitor and steer your agents from your phone.


Community & Support

  • Discord: Join the community on Discord.

  • Twitter / X: Follow @orca_build for updates and announcements.

  • WeChat: Scan to join an Orca community WeChat group.

    WeChat QR code for the Orca community
  • 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.

Orca contributors

GitHub star history chart for stablyai/orca

Signed Builds

Windows code signing sponsored/provided by SignPath.io, certificate by SignPath Foundation.

License

Orca is free and open source under the MIT License.

S
Description
Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
Readme MIT
2.7 GiB
Languages
TypeScript 95.6%
JavaScript 3.4%
Swift 0.3%
CSS 0.2%
Python 0.1%
Other 0.1%