b23fcf3b2b
* Allow Windows SSH directory browsing to recover The remote project picker runs before the relay filesystem ACLs exist, so it uses a raw SSH exec channel with POSIX shell commands. Windows OpenSSH targets whose default shell is cmd.exe reject Orca's POSIX exec wrapper, which prevented browsing any remote directories. Keep the existing POSIX path as the first attempt, then fall back to a narrowly scoped PowerShell listing that emits the same line-based format. Constraint: Add Remote Project needs raw SSH browsing before relay roots are registered Constraint: Windows OpenSSH may use cmd.exe as the remote command shell Rejected: Replace the POSIX command for all hosts | riskier for existing Linux/macOS SSH targets Confidence: medium Scope-risk: narrow Directive: Keep POSIX browsing as the primary path; Windows fallback exists only for shell-wrapper rejection errors Tested: npx --yes pnpm@10.24.0 exec vitest run --config config/vitest.config.ts src/main/ipc/ssh-browse.test.ts Tested: npx --yes pnpm@10.24.0 exec oxlint src/main/ipc/ssh-browse.ts src/main/ipc/ssh-browse.test.ts Tested: npx --yes pnpm@10.24.0 exec oxfmt --check src/main/ipc/ssh-browse.ts src/main/ipc/ssh-browse.test.ts Tested: npx --yes pnpm@10.24.0 run typecheck:node Not-tested: Live Windows OpenSSH host with cmd.exe default shell * fix(ssh-browse): strip CRLF in Windows PowerShell browse output Windows OpenSSH exec emits CRLF, but the browse parser split on \n only and never stripped the trailing \r. Every directory line then failed the endsWith('/') check and was misclassified as a file with a stray CR in its name (and resolvedPath kept a trailing \r) — breaking the exact Windows path this PR adds. Split on /\r?\n/ to match the existing ssh-relay-versioned-install convention; POSIX (LF-only) output and filenames with legitimate leading/trailing spaces are unaffected. The added fallback test used \n-only fixtures that no real Windows host produces, masking the bug; switch it to realistic CRLF output so it now guards the regression. Co-authored-by: Orca <help@stably.ai> * fix(ssh-browse): locale-independent Windows fallback + UTF-8 output - Trigger the PowerShell fallback on cmd.exe's locale-independent 9009 exit code, not just English/Spanish stderr text, so non-English Windows hosts actually recover. - Pin [Console]::OutputEncoding to UTF-8 in the PowerShell script so non-ASCII names (e.g. C:\Users\José, CJK, Cyrillic) aren't mojibake'd when decoded. - Rethrow the original POSIX error when the PowerShell retry also fails, so a false-positive predicate match doesn't mask the real failure. - Tests: decode the -EncodedCommand payload to guard injection-safe escaping and the UTF-8 pin; add a 9009-locale fallback case and a negative-predicate (permission denied must not retry) case. - Drop an incorrect sentence from the CRLF-split comment. Co-authored-by: Orca <help@stably.ai> * fix(ssh-browse): surface PowerShell error on proven-Windows fallback When the fallback was triggered by cmd.exe's 9009 exit, the host is provably Windows and PowerShell genuinely ran, so its error ('Cannot find path' / 'Access is denied') is the real cause — surface it instead of the misleading cmd.exe "exec is not recognized" prose. Only the string-heuristic path (a possible POSIX false positive) still rethrows the original error. Also: note the system-ssh transport's 8-bit exit-code truncation caveat in the 9009 comment, and add tests for both double-failure paths (9009 -> surface PowerShell error; heuristic -> surface original). Co-authored-by: Orca <help@stably.ai> * test(ssh-browse): guard the ~ -> $HOME PowerShell fallback branch The tilde expansion in powerShellPathExpression (~ is the default browse path) was unguarded — collapsing it to a literal would pass the whole suite. Add a fallback test asserting the decoded script contains $dir = $HOME. Also tighten the 9009 comment: the locale-independent trigger only holds for a cmd.exe DefaultShell on the ssh2 transport; a powershell.exe DefaultShell exits 1 (not 9009) and, like the system-ssh transport, relies on the stderr heuristics. Co-authored-by: Orca <help@stably.ai> * fix(ssh-browse): emit forward-slash resolvedPath from Windows fallback Get-Location.ProviderPath returns a native backslash path (C:\Users\alice), but the renderer's parentPath/joinPath only split on '/': backslash paths make the browser's 'Up' button a no-op and produce mixed separators when descending. Normalize the emitted resolvedPath to forward slashes (matching the POSIX branch) while keeping the native $resolved for Get-ChildItem -LiteralPath. Update the fallback-test fixtures to the real forward-slash output and assert the -replace normalization is present in the generated script. Co-authored-by: Orca <help@stably.ai> * fix(ssh-browse): root Windows drive paths in the PowerShell fallback The forward-slash resolvedPath means the renderer rebuilds Windows paths with POSIX helpers, so it hands back drive paths Set-Location mishandles: the breadcrumb prepends a spurious leading '/' (/C:/Users -> current drive's root), and 'Up' from a first-level dir yields a bare drive letter ('C:' is drive-relative, not C:\). Normalize both to a rooted drive path in powerShellPathExpression so navigation lands where the user clicked. POSIX, UNC, and relative paths are left untouched. Add parametrized tests for /C:/Users and C: -> rooted $dir literals. Co-authored-by: Orca <help@stably.ai> * test(ssh-browse): cover combined /C: drive-path normalization Guards the strip-then-root ordering in normalizeWindowsDrivePath so a future refactor can't regress the combined leading-slash + bare-drive case. Co-authored-by: Orca <help@stably.ai> * fix(ssh-browse): trigger Windows fallback on non-zero exit, not exit 9009 Verified on real Windows OpenSSH + cmd.exe that a rejected POSIX exec wrapper arrives over SSH as process exit code 1, not 9009 (cmd.exe's 9009 ERRORLEVEL never crosses its process boundary; sshd forwards the process exit code). Confirmed on both the ssh2 and system-ssh transports. The old trigger keyed off exit 9009 (dead code) with an English/Spanish stderr string fallback, so non-English cmd.exe hosts (German/French/ Japanese/etc.) never fell back and directory browsing failed. Fix: retry via PowerShell whenever the POSIX attempt fails with a RemoteBrowseError (command ran, exited non-zero) - locale-independent and covers every cmd.exe locale. Transport errors/timeouts aren't RemoteBrowseErrors, so dropped connections aren't mis-retried. Pick the error to surface via the POSIX "command not found" exit 127 (no powershell.exe means the host isn't Windows, so surface the original POSIX error). Removes the fragile 9009/stderr-string heuristics. Tests: correct injected exit codes to the real value (1), add a Japanese-locale regression test, and lock the retry/no-mask contract. --------- Co-authored-by: Jinwoo-H <jinwoo0825@gmail.com> Co-authored-by: Orca <help@stably.ai> Co-authored-by: Jinwoo Hong <73622457+Jinwoo-H@users.noreply.github.com>
Orca
Español · Português · 中文 · 日本語 · 한국어
The AI Orchestrator for 100x builders.
Run Codex, ClaudeCode, OpenCode or Pi side-by-side — each in its own worktree, tracked in one place.
Download Orca
Features
Mobile CompanionMonitor and steer your agents from your phone — get notified when an agent finishes and send follow-ups from anywhere. |
 |
Parallel WorktreesFan one prompt across five agents, each in its own isolated git worktree — compare the results and merge the winner. |
 |
Terminal SplitsGhostty-class terminals with WebGL rendering, infinite splits, and scrollback that survives restarts. |
 |
Design ModeClick any UI element in a real Chromium window to send its HTML, CSS, and a cropped screenshot straight into your agent's prompt. |
 |
GitHub & Linear, NativeBrowse PRs, issues, and project boards in-app — open a worktree from any task and review without a context switch. |
 |
SSH WorktreesRun agents on a beefy remote box with full file editing, git, and terminals — auto-reconnect and port forwarding included. |
 |
Annotate AI DiffsDrop comments on any diff line and ship them back to the agent — review, edit, and commit without leaving Orca. |
 |
Drag Files to AgentsVS Code's editor with autosave everywhere — drag files or images straight into an agent prompt. |
 |
Orca CLIAgents drive Orca too — script every workflow with |
 |
Also in the box:
- Quick open — Search across worktrees, files, agents, commands, and repo context without leaving your flow.
- Account switcher & usage tracking — See Claude and Codex usage and rate-limit resets, and hot-swap accounts without re-logging in.
- Rich repo previews — Preview Markdown, images, PDFs, and repo docs in the workspace.
- Computer Use — Let agents operate desktop apps and visible UI when a workflow needs real interaction.
- Notifications and unread state — Know when an agent finishes or needs attention, then mark threads unread to come back later.
- 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
Codex
Grok
Cursor
GitHub Copilot
OpenCode
MiMo Code
Amp
OpenClaude
Antigravity
Pi
oh-my-pi
Hermes Agent
Devin
Goose
Auggie
Autohand Code
Charm
Cline
Codebuff
Command Code
Continue
Droid
Kilocode
Kimi
Kiro
Mistral Vibe
Qwen Code
Rovo Dev
+ any CLI agent
Install
Desktop — macOS, Windows, Linux
- Download from onOrca.dev
- Or grab a build directly: macOS Apple Silicon · macOS Intel · Windows (.exe) · Linux AppImage · All builds
- Running
orca serveon a headless Linux server? See the headless Linux server guide.
Or via a package manager:
# macOS (Homebrew)
brew install --cask stablyai/orca/orca
# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-bin
Mobile Companion — iOS, Android
Pair with your desktop app to monitor and steer your agents from your phone.
- iOS: Download on the App Store or join TestFlight
- Android: Download APK 0.0.24
Community & Support
-
Discord: Join the community on Discord.
-
Twitter / X: Follow @orca_build for updates and announcements.
-
WeChat: Scan the QR code to join the 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.
License
Orca is free and open source under the MIT License.