> ## 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://app.replicas.dev). On macOS, Google and Apple sign-in open in a separate window and return to the main app after authentication. On Linux, OAuth stays inside the app. Other external links open in your default browser.

## Local tunnels

Open a workspace's **Tunnels** tab beside **Terminal**, select **Add**, and enter the service port. You can optionally choose a different local port. Active tunnels listen only on your computer's loopback address, and **Open** launches the service in your default browser.

Tunnels run while the desktop app and workspace are active. Edit a tunnel to recreate it with new ports, or remove it when you are done. Wake a sleeping workspace from the tab before adding a tunnel.

## 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 visible with your active sidebar views and filters can trigger notifications. 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.