orca/README.md

<p align="center">
  <a href="https://onOrca.dev"><img src="resources/build/icon.png" alt="Orca" width="128" /></a>
</p>

<h1 align="center">Orca</h1>

<p align="center">
  <a href="https://github.com/stablyai/orca/stargazers"><img src="https://img.shields.io/github/stars/stablyai/orca?style=flat-square&color=black" alt="GitHub stars" /></a>
  <img src="https://img.shields.io/badge/Platform-macOS%20%7C%20Windows%20%7C%20Linux-black?style=flat-square" alt="Supported Platforms" />
  <img src="https://img.shields.io/badge/ships-150+-black?style=flat-square" alt="Ships" />
  <a href="https://x.com/orca_build"><img src="https://img.shields.io/twitter/follow/orca_build?style=social" alt="Follow on X" /></a>
</p>

<p align="center">
  <strong>The AI Orchestrator for 100x builders.</strong><br/>
  Run Claude Code, Codex, or OpenCode side-by-side across repos — each in its own worktree, tracked in one place.<br/>
  Available for <strong>macOS, Windows, and Linux</strong>.
</p>

<p align="center">
  <a href="https://onOrca.dev"><strong>Download at onOrca.dev</strong></a>
</p>

<p align="center">
  <img src="docs/assets/file-drag.gif" alt="Orca Screenshot" width="800" />
</p>

## [New] Built-in Browser & Design Mode

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

Orca ships with a built-in browser right inside your IDE. 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.

<p align="center">
  <img src="orca-design-mode.gif" alt="Orca Design Mode — click any UI element and drop it into the chat" width="800" />
</p>

---

## [New] Introducing the Orca CLI

**Agent orchestration from your terminal.**

Let your AI agent control your IDE. Use AI to add repos 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).

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

---

## Features

- **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

Get started today:

- **[Download from onOrca.dev](https://onOrca.dev)**
- Or download the latest binaries via the **[GitHub Releases page](https://github.com/stablyai/orca/releases)**.

---

## Community & Support

- **Twitter / X:** Follow [**@orca_build**](https://x.com/orca_build) for updates and announcements.
- **Feedback & Ideas:** We ship fast. Missing something? [Request a new feature](https://github.com/stablyai/orca/issues).
- **Show Support:** Star this repo to follow along with our daily ships.

---

## Developing

Want to contribute or run locally? See our [CONTRIBUTING.md](CONTRIBUTING.md) guide.