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

# Desktop app

> Rerun for macOS, Windows and Linux, with notifications, a menu bar or tray icon and Quick ask.

The desktop app is Rerun in a window of its own. Everything you see is the same app as in your browser, updated at the same time, plus what a browser tab cannot do.

## Install

Download Rerun from [rerun.build/download](https://rerun.build/download). The app updates itself: when a new version is ready, a message offers to restart.

* **macOS** 13 or later: take the `.dmg` for your Mac's chip (Apple Silicon or Intel, shown in **Apple menu > About This Mac**), open it and drag **Rerun** to your **Applications** folder.
* **Windows** 10 or later, in beta: run the installer for your PC (x64, or Arm on a Windows on Arm PC). The Windows app is not signed yet, so Windows may show **Windows protected your PC**: click **More info**, then **Run anyway**.
* **Linux** x64: the AppImage runs on most distributions and updates itself (make it executable, then open it). A `.deb` and a `.rpm` are there too.

## Sign in

Click **Sign in with Google** or **Sign in with Apple**. Your browser opens on Rerun and asks you to confirm the account: click **Continue**, and the app signs in on its own.

If the app does not open by itself, the browser shows a code. In the app, click **Paste a code instead**, paste it, and click **Sign in**. The code works once, for two minutes.

You can also sign in with an email code or your phone number, right in the app.

## What the app adds

* **Notifications** from your coworkers as soon as you are in another app. Click one to open the conversation.
* **What waits for you on the app icon**: a count on the Dock icon on a Mac, a dot on the taskbar icon on Windows. The app also keeps an icon in the menu bar on a Mac, in the notification area on Windows and Linux.
* **Quick ask**: press <kbd>⌘</kbd> <kbd>⇧</kbd> <kbd>Space</kbd> (<kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>Space</kbd> on Windows and Linux) from any app, type a question for your Chief of Staff, press <kbd>Enter</kbd>. The app opens on the answer. Rather talk? Hold <kbd>Space</kbd> in the empty field, ask your question out loud and let go: it is sent as soon as it is written out. Or press <kbd>⌥</kbd> <kbd>⇧</kbd> <kbd>Space</kbd> (<kbd>Alt</kbd> <kbd>Shift</kbd> <kbd>Space</kbd> on Windows and Linux) from any app: Quick ask opens listening, press the shortcut again or <kbd>Enter</kbd> to send, <kbd>Esc</kbd> to cancel. You can pick another shortcut in the settings.
* **The coworker dock**: once you have a coworker, a small bar on the right edge of the screen, above every app and on every desktop, with one buddy per coworker. Each buddy shows whether its coworker is working, waiting for an answer, failed or at rest. A number on a buddy counts what it has for you: an answer you have not read, a question, an approval; it turns red when the coworker failed. Click a buddy to open its conversation, or **+** to create a coworker. Drag the grip at the top along the edge, or to the other side of the screen; double-click it to fold the dock into a tab. Point at the dock and drag the short line that shows above or below it to set how tall the dock may grow: past that, its coworkers scroll. Double-click that line to let it grow with them again. Right-click the dock to fold it, move it to the other edge or hide it.
* **Open from your email**: in a browser where you signed the app in, Rerun offers to open the page in the app.
* **More than one window**: **File** > **New Window**.
* **Link this computer**: your coworkers run commands, use files and start long jobs on it, each time with your yes. See [Computers](https://docs.rerun.build/computers.md).

[![The Quick ask window over another app, with a question for the Chief of Staff typed in](https://docs.rerun.build/images/desktop-app/quick-ask.light.webp)](https://docs.rerun.build/images/desktop-app/quick-ask.light.webp)
[![The Quick ask window over another app, with a question for the Chief of Staff typed in](https://docs.rerun.build/images/desktop-app/quick-ask.dark.webp)](https://docs.rerun.build/images/desktop-app/quick-ask.dark.webp)

On a Mac, closing the window keeps Rerun running, so notifications still arrive: quit from the menu bar icon or with <kbd>⌘</kbd> <kbd>Q</kbd>. On Windows and Linux, closing the window leaves Rerun in the notification area while **Keep running when closed** is on, which it is by default. Quit from its icon.

## Settings

Open your account from the workspace menu and pick the **Desktop app** tab:

* **Open at login** starts Rerun with your computer, in the menu bar or the notification area.
* **Quick ask** shows its shortcut. Click it and press the keys you want instead: the shortcut needs <kbd>⌘</kbd>, <kbd>⌥</kbd> or <kbd>⌃</kbd> (<kbd>Ctrl</kbd> or <kbd>Alt</kbd> on Windows and Linux), and keys the system or another app already uses are refused. Press <kbd>Esc</kbd> to keep the current one, or <kbd>⌫</kbd> to turn Quick ask off; record a shortcut again to turn it back on.
* **Voice quick ask** is the shortcut that opens Quick ask listening, changed or turned off the same way.
* **Coworker dock** shows or hides the dock of coworkers on the edge of the screen. It is on by default.
* **Keep running when closed**, on Windows and Linux: closing the window leaves Rerun in the notification area, so notifications still arrive. Turn it off to quit when you close the window.
* **Updates** shows the version and checks for a new one.
* **This computer** links this computer to your workspace, or shows it linked, with **Pause** and **Unlink this computer**. See [Computers](https://docs.rerun.build/computers.md).

[![The Desktop app tab of the account: this computer linked to Acme Studio, Open at login, the Quick ask shortcuts and the coworker dock](https://docs.rerun.build/images/desktop-app/desktop-settings.light.webp)](https://docs.rerun.build/images/desktop-app/desktop-settings.light.webp)
[![The Desktop app tab of the account: this computer linked to Acme Studio, Open at login, the Quick ask shortcuts and the coworker dock](https://docs.rerun.build/images/desktop-app/desktop-settings.dark.webp)](https://docs.rerun.build/images/desktop-app/desktop-settings.dark.webp)

## Your own server

The app works with a self-hosted Rerun too. Click **Change Server…** (in the **Rerun** menu on a Mac, in the **File** menu on Windows and Linux), or **Use another Rerun server** on the sign-in screen, and enter the address of your server. **Use Rerun Cloud** brings you back. See [Desktop app](https://docs.rerun.build/self-host/desktop.md).

## Other apps

Rerun also runs in your browser, and in the [iPhone app](https://docs.rerun.build/iphone-app.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.