mirror of
https://github.com/stablyai/orca.git
synced 2026-10-01 16:02:03 +00:00
Jinjing
45c4823109
Standardize MDX files across docs with: - Remove trailing semicolons from import statements - Wrap long lines and multi-line component props for readability - Align Markdown table column separators - Normalize text and JSX formatting for consistency
91 lines
3.7 KiB
Plaintext
91 lines
3.7 KiB
Plaintext
---
|
||
title: Install
|
||
description: Download Orca for macOS, Windows, or Linux, and opt into RC builds.
|
||
---
|
||
|
||
import { Callout } from '@/components/docs/prose'
|
||
|
||
## Download
|
||
|
||
<div className="my-4 rounded-md border border-border bg-card p-4 md:hidden">
|
||
<p className="mb-3 text-sm text-muted-foreground">
|
||
Orca is a desktop app. Download the latest build for your platform from GitHub:
|
||
</p>
|
||
<a
|
||
href="https://github.com/stablyai/orca/releases/latest"
|
||
className="inline-flex min-h-10 items-center rounded-md bg-primary px-4 text-sm font-medium text-primary-foreground transition-colors hover:bg-primary/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/50"
|
||
>
|
||
Download latest release
|
||
</a>
|
||
</div>
|
||
|
||
<ul className="hidden md:block">
|
||
<li>
|
||
**macOS:** [Apple
|
||
Silicon](https://github.com/stablyai/orca/releases/latest/download/orca-macos-arm64.dmg) ·
|
||
[Intel](https://github.com/stablyai/orca/releases/latest/download/orca-macos-x64.dmg)
|
||
</li>
|
||
<li>
|
||
**Windows:**
|
||
[installer](https://github.com/stablyai/orca/releases/latest/download/orca-windows-setup.exe)
|
||
</li>
|
||
<li>
|
||
**Linux:**
|
||
[AppImage](https://github.com/stablyai/orca/releases/latest/download/orca-linux.AppImage) ·
|
||
[.deb](https://github.com/stablyai/orca/releases)
|
||
</li>
|
||
<li>Older versions: [GitHub Releases](https://github.com/stablyai/orca/releases).</li>
|
||
</ul>
|
||
|
||
### Homebrew (macOS)
|
||
|
||
Orca is also published as a Homebrew cask, auto-bumped on every stable release:
|
||
|
||
```
|
||
brew install --cask stablyai/orca/orca
|
||
```
|
||
|
||
`brew upgrade --cask orca` picks up new stable builds. The cask tracks the stable channel — for RC builds, use the GitHub Releases links above or the in-app **Check for Updates** flow described under [Updates](#updates).
|
||
|
||
## First launch
|
||
|
||
On first launch Orca will:
|
||
|
||
- Ask for access to your home directory so it can add repos.
|
||
- Offer to import `~/.claude`, `~/.codex`, and Ghostty terminal settings if present.
|
||
- Drop you on an empty landing screen where you add your first repo.
|
||
|
||
## Updates
|
||
|
||
Orca auto-updates by default, tracking the **stable** channel. Stable releases are vetted; **RC (release candidate)** builds ship new features first, often daily.
|
||
|
||
There is no permanent in-app opt-in for the RC channel. Modifier clicks on **Check for Updates** ([Settings → General → Updates](/docs/settings), or the app / Help menu):
|
||
|
||
| Modifier | Effect |
|
||
| ------------------------------------------------------ | ------------------------------------------------------------------------------ |
|
||
| **Shift+click** | Include the latest **RC** prerelease |
|
||
| **Cmd+click** (macOS) / **Ctrl+click** (Windows/Linux) | Latest **perf**-tagged prerelease |
|
||
| **Option+click** (macOS only) | Pick a **validated local macOS build** that passes Orca’s compatibility checks |
|
||
|
||
You can still download any build directly from the [GitHub Releases page](https://github.com/stablyai/orca/releases).
|
||
|
||
<Callout title="Don't like the current update">
|
||
Older versions are always available on the [GitHub Releases
|
||
page](https://github.com/stablyai/orca/releases). Orca will not force-downgrade your worktree data
|
||
if you go back.
|
||
</Callout>
|
||
|
||
## Platform notes
|
||
|
||
### macOS
|
||
|
||
Signed and notarized. On first launch, macOS may still ask you to confirm — that's normal for Electron-based apps.
|
||
|
||
### Windows
|
||
|
||
The default shell can be set to PowerShell or CMD under [Settings → Terminal](/docs/settings). Most users want PowerShell.
|
||
|
||
### Linux
|
||
|
||
AppImage and `.deb` builds are available. See the Releases page for details.
|