Orca NP

_{中文 · 日本語 · 한국어 · Español · Français · Português}

🔱 This is Orca NP — a fork of stablyai/orca with its own features, fixes, and releases.
_{Installs beside the official Orca · Download the latest Orca NP build · See what's different ↓}

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 NP

What's different in this fork

Orca NP is stablyai/orca plus a series of fork-only features and fixes. The upstream feature list below still applies (except where a build isn't published here — see Install); this is what Orca NP adds on top. The full list is in the merged pull requests, and the fork-only patch series is documented in LOCAL-PATCHES.md.

Tasks, issues, and Jira

• Jira board view — pick a default board and the Jira tab shows columns, the active sprint, and the backlog, with drag-to-move between columns, a filter box, and priority colors.
• Lane drops that stick — dropping a Jira item on a lane resolves the transition, asks for the fields that transition's screen requires, and moves the card before Jira confirms it, rolling back only if Jira refuses.
• Sprints, story points, and custom fields — move a backlog item onto a sprint from its row or the issue drawer, set or clear story points beside status, priority, and assignee, and edit custom user-picker fields (Dev, QE) from the issue detail. A sprint change made in the open issue reloads the board.
• "Me" matches every role field — an issue where you are the Dev or the QE, not only the assignee, now appears under the board's Me filter.
• Searchable assignee picker — with you and your team pinned to the top.
• Linked issue in the right sidebar — a workspace created from a Jira, Linear, or GitHub issue gets an Issue tab with status, assignee, priority, labels, description, and an Open button. Jira issues also get unlink/re-link, a live Markdown comment box, and correct rendering of self-hosted Jira (Server/Data Center) descriptions. A GitHub issue is read from the repo it came from, so a workspace in another project still loads it, and when that repo is not on this machine, the tab says so instead of failing.
• Link a workspace to a Jira issue by key or URL from its details dialog; the Tasks page shows an attached-workspace chip and opens the existing workspace instead of creating a duplicate.

Pull request review and CI

• Inline GitHub PR comments — comments appear under their line in the editor, with reply, resolve, and collapse (shown only when your checkout matches the PR's head commit).
• Merge readiness at a glance — the PR icon keeps its CI color and adds a dot for outstanding approvals, conflicts, or blocks, with the reason in the tooltip. Works across GitHub, GitLab, Bitbucket, Azure DevOps, and Gitea.
• Review verdicts in the Checks panel — Approved / Changes requested with reviewer names, and the panel updates when CI changes instead of waiting for a tab switch.
• A live Checks panel — while a run is in flight an open panel refreshes every 10s instead of waiting out the review cadence, slowing to 20s and then 30s while nothing changes, and its verdict updates the sidebar card and activity-bar icons (GitHub).
• Jenkins build details — expand a Jenkins check to see its stages, which one is running or failed, and the build facts.
• Admin merge for review-gated PRs — if your account may bypass branch protection, Merge is offered after a confirmation that names what gets skipped.

Agents

• Session summaries — a written brief of an agent session (activity, goal, plan, blockers, timeline) in the right sidebar, with its own agent/model setting. Covers Pi, Copilot, OpenCode, and Cursor sessions as well; a session on a paired host is briefed on that host, and one on an SSH target is briefed from its streamed transcript.
• More accurate agent status — Pi rows no longer stick on "Working" or turn "Done" when a helper sub-agent finishes; Copilot CLI no longer raises "needs you" for auto-approved prompts; a Grok sub-agent waiting on you keeps its row waiting; a pane restored on another client drops the needs-input marker its dialog left behind; and a Claude sub-agent a pi session launches through the claude CLI stays on the pi session's row (needs a current pi-subagents plugin).
• Copilot's prompts are read from the screen — a shell or URL approval and the "Copilot needs information" dialog show as prompts instead of a spinner, while a permission the CLI approved on its own stays quiet.
• Focus stays in the agent tab — clicking a sidebar card, a right-sidebar activity tab, or the panel background hands the keyboard back to the agent tab, and closing a menu or dialog returns the caret too, so the next keystroke still means what it did.
• Clipboard follows the reader — a copy from a pi pane watched from a paired client lands in that client's clipboard as well as the host's.
• One-click default agent — the + button in the tab bar launches your default agent; hold it or use the chevron for the full menu.
• Agent Dashboard as a page — opens in the main window with back/forward, and clicking a card opens that agent's workspace.
• Agent session history — "All" really lists every session, sub-agent sessions nest under their parent, and transcript indexing makes existing transcripts searchable. A paired host's history loads in pages and refreshes only what changed, so a large remote history arrives instead of failing.
• Usage tracking for more providers — Copilot enterprise AI-credit budgets, DeepSeek balance, and Fireworks.ai spend in the status bar, plus a per-provider off switch that stops polling and credential reads. An expired Claude login is refreshed from the stored refresh token rather than sitting at "Updates when Claude runs", and the renewed login is saved back where Claude keeps it.

Workspaces and layout

• One folder per project — the main checkout and all its worktrees live together under one folder with a shared AGENTS.md; orca repo relocate moves existing checkouts into it.
• Grouped workspaces across machines — the same branch on two hosts becomes one card with a host dropdown. A workspace on a paired host reads its GitHub issue and PR from that host, and its status dot stops spinning once the host's agents finish.
• Paired clients stay in step — projects and workspaces a host adds or removes, including ones created in that host's own window or from its CLI, reach its paired clients without a manual refresh.
• Status filter — hide chosen statuses from the sidebar and Cmd+J while the board still shows everything.
• "Setting up…" indicator while a repo's setup script runs, including for workspaces started without an agent.
• Shared-directory modes — symlink, APFS clone, copy, or skip for directories shared between worktrees.
• Floating workspace — a home folder of its own, a drag handle on the titlebar, and the same agent launch control as the main tab bar.
• Hide auto-imported SSH hosts from pickers and the status bar; hidden hosts stay listed under Settings.
• Faster, honest file filter — the Explore filename filter searches the whole workspace from a prebuilt index and says so when results are partial instead of "no files match".
• Host settings replication (groundwork) — one machine's settings and provider credentials can be replicated to paired hosts.

Ephemeral environments

Additions to upstream's per-workspace environment recipes (Settings → Experimental → Cloud VM):

• Lease countdown and Extend — a recipe that publishes when the provider takes the host away gets a countdown on the workspace card and in Settings, and, when it also declares how to extend, an Extend action limited to the lifetimes it lists. Past the deadline the card and Settings show the lease as expired; once a further 15 minutes have passed and Orca's connection to the host has failed, Orca removes the workspace from its list, and the provider's machine is left to its own expiry or to Cleanup in Settings.
• Recipe-declared context-menu items — up to 20 actions a recipe declares get their own entries in that workspace's context menu and run with the workspace's host, name, and path. They are declared in orca.yaml, so they are covered by the recipe's approval, and a recipe that declares none adds no entries.

Reliability

• Git hooks and ssh-agent auth work when the packaged app is launched from the Dock, because git now sees the exports from your shell profile.
• macOS computer-use permissions no longer split across two helper identities.
• Right-click paste into Copilot CLI pastes once, not twice.
• An opt-in "Log UI hangs" diagnostic writes stall records, with focus, sleep, and CPU context, to help track down beachballs.

Running it

• Own identity — Orca NP uses its own app id (com.nplez1.orca), data directory, home directory (~/.orca-np), and CLI (orca-np), so it installs and runs beside an official Orca without sharing state.
• Own releases and updates — builds are tagged v<upstream version>-np.<n> and the in-app updater follows this repository's releases, not upstream's.
• Signing — macOS builds are signed and notarized; the Windows installer is unsigned, so SmartScreen warns once on install.
• No telemetry — the release notes state that builds send no diagnostics or usage data.
• Skills point at this app — bundled skills and the published stubs call orca-np (and orca-np-dev in development) rather than falling through to an official install's orca.
• Fresh profile — Orca NP cannot read an official Orca install's repos, credentials, or paired devices; that separation is deliberate, so pair your phone with Orca NP separately.
• Tracks upstream — upstream main is merged in regularly (the procedure is in UPSTREAM-SYNC-RUNBOOK.md), so the fork receives upstream features and fixes too.

---

Features

The feature wall below is upstream Orca's; its "Docs" links go to upstream's documentation at onorca.dev, which doesn't cover the fork-only features above.

Mobile Companion Monitor and steer your agents from your phone — get notified when an agent finishes and send follow-ups from anywhere. iOS App Store · Android APK · Docs →
Parallel Worktrees Fan one prompt across five agents, each in its own isolated git worktree — compare the results and merge the winner. Docs →
Terminal Splits Ghostty-class terminals with WebGL rendering, infinite splits, and scrollback that survives restarts. Docs →
Design Mode Click any UI element in a real Chromium window to send its HTML, CSS, and a cropped screenshot straight into your agent's prompt. Docs →
GitHub & Linear, Native Browse PRs, issues, and project boards in-app — open a worktree from any task and review without a context switch. Docs →
SSH Worktrees Run agents on a beefy remote box with full file editing, git, and terminals — auto-reconnect and port forwarding included. Docs →
Annotate AI Diffs Drop comments on any diff line and ship them back to the agent — review, edit, and commit without leaving Orca. Docs →
Drag Files to Agents VS Code's editor with autosave everywhere — drag files or images straight into an agent prompt. Docs →
Orca CLI Agents drive Orca too — script every workflow with orca worktree create, snapshot, click, and fill. Docs →

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 Orca NP releases are the real feature list for this fork, and upstream's for everything it inherits.

---

Supported Agents

Works with any CLI agent — if it runs in a terminal, it runs in Orca.

Claude Code   Codex   Grok   Cursor   GitHub Copilot   Muse   DeepSeek Harness   ZCode   OpenCode   MiMo Code   Amp   OpenClaude   Antigravity   Pi   oh-my-pi   Hermes Agent   Devin   Goose   Auggie   Autohand Code   Charm   Cline   CodeBuddy   Codebuff   Freebuff   Command Code   Continue   Droid   Kilocode   Kimi   Kiro   Mistral Vibe   Qwen Code   Rovo Dev   + any CLI agent

---

Install

Desktop — macOS, Windows, Linux

• Download the latest Orca NP release
• Or grab a build directly: macOS Apple Silicon · macOS Intel · Windows (.exe) · Linux (AppImage) · All builds

Orca NP installs beside an official Orca and updates itself from this repository's releases. The Linux build is x86_64 only: the AppImage updates itself, while the .deb and .rpm install the same app under a package manager and are updated by installing a newer release. This fork does not publish a Homebrew/AUR package.

Mobile Companion — iOS, Android

Pair the Orca mobile app with Orca NP to monitor and steer your agents from your phone. The apps are published by upstream Orca and work with Orca NP.

• iOS: Download on the App Store
• Android: Download APK · Install guide

---

Community & Support

• Orca NP issues & ideas: Open an issue for anything specific to this fork.

• Upstream community: upstream Orca's channels cover everything this fork inherits — Discord, @orca_build on X, and upstream issues for bugs that also reproduce in official Orca.

• Upstream WeChat group: group 12 is full. Scan to join Orca community WeChat group 13.

  

• Docs: onorca.dev/docs documents upstream Orca.

• Show support: Star this repo to follow the fork, or upstream.

---

Developing

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

The relay that pairs the mobile app with a desktop host is also in this repository under cloud/, with a separate pnpm workspace and setup guide.

Signed Builds

Orca NP's Windows installer is unsigned. Upstream Orca's Windows builds are signed with code signing sponsored by SignPath.io, certificate by SignPath Foundation.

License

Orca is free and open source under the MIT License.