> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replicas.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Desktop app

> Run Replicas in a focused macOS or Linux window.

The desktop app is a lightweight native window around Replicas, so it tracks web deployments without requiring a new download.

<CardGroup cols={2}>
  <Card title="Apple Silicon" icon="apple" href="https://api.replicas.dev/v1/desktop/download/macos/arm64">
    Download for M-series Macs
  </Card>

  <Card title="Intel" icon="apple" href="https://api.replicas.dev/v1/desktop/download/macos/x64">
    Download DMG for Intel Macs
  </Card>

  <Card title="Linux x64" icon="linux" href="https://api.replicas.dev/v1/desktop/download/linux/appimage/x64">
    Download AppImage for x64 Linux
  </Card>

  <Card title="Debian x64" icon="linux" href="https://api.replicas.dev/v1/desktop/download/linux/deb/x64">
    Download Debian package for x64 Linux
  </Card>

  <Card title="Linux arm64" icon="linux" href="https://api.replicas.dev/v1/desktop/download/linux/appimage/arm64">
    Download AppImage for arm64 Linux
  </Card>

  <Card title="Debian arm64" icon="linux" href="https://api.replicas.dev/v1/desktop/download/linux/deb/arm64">
    Download Debian package for arm64 Linux
  </Card>
</CardGroup>

On macOS, open the DMG, drag **Replicas** into **Applications**, and launch it. Builds require macOS 12 or later. On Linux, run the AppImage or install the Debian package.

Sign in as you do on the [web app](https://replicas.dev/home). OAuth popups stay inside the app, while other external links open in your default browser.

## macOS turn notifications

Replicas sends a native notification when a turn finishes while the app is minimized or in the background. If messages remain queued, Replicas waits until every queued turn finishes. Only regular workspaces in your active sidebar view can trigger notifications; mothership activity stays silent. Select the notification to reopen its workspace. Notifications are suppressed while the app is focused.

Closing the window keeps Replicas running so notifications can arrive. Quit Replicas with **Command-Q** to stop background notifications.

## Open links in the app

Turn on **Open links in the desktop app** under **Dashboard → Personal → Preferences** to hand app, dashboard, and workspace links off to the desktop app. A Replicas link you click in Slack, Linear, or GitHub opens the app on that page instead of a browser tab, on every browser you are signed in to.

Links to other pages, such as sign-in and marketing pages, stay in the browser. Add `?desktop=0` to any link to keep that one in the browser too.

The setting only takes effect on macOS and Linux, where the app runs. Without the app installed the page stays in your browser, though browsers that ask before opening an app still ask first. Each browser tab attempts the hand-off at most once, so that prompt cannot repeat as you move around the app.

The macOS app checks for desktop updates automatically. When an update is ready, restart immediately or choose **Later** to install it the next time you open the app. Linux users install new packages from this page. Web app updates appear without a desktop update.