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

Apple Silicon

Download for M-series Macs

Intel

Download DMG for Intel Macs

Windows

Download installer for Windows 10 or later

Linux x64

Download AppImage for x64 Linux

Debian x64

Download Debian package for x64 Linux

Linux arm64

Download AppImage for arm64 Linux

Debian arm64

Download Debian package for arm64 Linux
On macOS, open the DMG, drag Replicas into Applications, and launch it. Builds require macOS 12 or later. On Windows, run the installer. It installs Replicas for your account without administrator access and opens it. If SmartScreen shows Windows protected your PC, select More info, then Run anyway. On Linux, run an AppImage from its download directory:
Or install the Debian package on Debian or Ubuntu:
Sign in as you do on the web app. On macOS, Google and Apple sign-in open in your default browser, where passkeys and security keys work, then return you to the app. On Linux, Google and Apple sign-in stay inside the app. Connecting GitHub, GitLab, Slack, Linear, Sentry, plugins, and MCP servers opens your default browser, where you are already signed in. For GitHub, GitLab, Slack, Linear, and Sentry, the browser first asks you to confirm the connection while signed in to Replicas as the same account. The app updates once you approve access. Connecting your personal Slack or Linear account opens an app window. Other external links open in your default browser.

Themes

Ask the agent in a workspace to change your theme for you, for example “make Replicas dark with a purple accent”. Your open web and desktop apps change right away. To set it yourself, select Appearance in the account menu at the bottom of the sidebar to open Personal → Appearance. The Themes tab is a gallery of complete themes people published: open one to apply it or star it, or choose Publish your theme to share your current colors, wallpaper, and fonts. The Avatars tab holds avatars people shared for Managers. On the Custom tab, Mode chooses Light, Dark, or System, each with its default color theme, and System follows your operating system’s appearance. Color theme lists light and dark themes for the backgrounds, text, and borders. Picking one switches the app to light or dark to match. Accent color sets the color of buttons, links, and highlights in every color theme. Status colors, such as green for passed checks, stay the same. Custom uses colors you pick. Name and save them to keep several custom themes, listed under light or dark by their background, and switch between them like any other color theme. Theme code holds them as one line of hex colors to copy and share, or to paste from someone else. Wallpaper shows an image, GIF, or video behind the home screen, with the effect None, Soft, Duotone, or Dither. Chat text size makes messages and the message box smaller or larger, and Font and Code font change the typeface, including Atkinson Hyperlegible for easier reading. Each font picker shows a sample. Use the upload button beside either picker to add a TTF, OTF, WOFF or WOFF2 file. Uploaded fonts stay in the browser or desktop app where you added them; built-in font choices sync across devices. On Linux, window borders follow your desktop environment’s theme.

Voice input

Voice input works as it does on the web. The app asks for microphone access the first time. If you denied it, allow Replicas under System Settings → Privacy & Security → Microphone on macOS, or turn on Microphone access under Settings → Privacy & security → Microphone on Windows.

Appshots on macOS

Press both Command keys in any app to attach that window to your message. Replicas comes forward with a screenshot of the window and the text in it, including text scrolled out of view, so the agent can read error messages, logs, and documents exactly. It goes to the chat you were just in, or starts a new workspace on Home if you’ve been away from Replicas for more than 15 minutes. Set Appshot destination to always use the last chat or always start a new workspace. From the composer, select + then Attach to capture the window right behind Replicas instead. Select an attachment to see its screenshot, and select Text (or press T) to check the text before you send. Before the first capture, Replicas asks for Screen Recording access, which captures the window, and Accessibility access, which adds its text. Without Accessibility, appshots attach the screenshot only. Change the keys, the destination, or the capture sound, turn Appshots off, or allow access later under Dashboard → Personal → Preferences → General.

Forward workspace ports

The desktop app tunnels every port the open workspace listens on to the same port on your computer over SSH. A dev server on :3000 is at http://localhost:3000, and a database on :5432 takes a local client. Switching workspaces switches the tunnels. Ports in Workspace info lists the workspace’s ports and previews. Ports already in use on your computer are never taken or remapped: they open the port’s preview if it has one, and the tunnel takes over a few seconds after you stop the local process. Turn tunnels off with the switch at the end of the row. The setting applies to this computer only. To tunnel one port from a terminal, use replicas tunnel.

Local control

Agents in your own workspaces can run commands on your Mac or Linux computer, such as a local Xcode build. When an agent needs your computer, it asks above the chat composer: select Allow to let that workspace in, and the prompt helps you open or download the desktop app if it isn’t running. Other workspaces still have to ask. Your computer in the workspace’s ⓘ info panel shows whether it has access, and turning it off cuts the agent off and stops its running commands at once. Access lasts while the workspace sleeps and wakes. There is nothing else to set up: no Remote Login, keys, or Tailscale. To skip the question, turn on Local control in every workspace under Dashboard → Personal → Preferences → General. To share a computer with a team environment instead, add it as a device. Agents reach the computer with ssh <computer name> '<command>', and scp and rsync work too. Commands run as you, in your home directory, with your login shell. Output streams back as it is produced, so the agent can follow a build that takes minutes.
  • It runs in the background. The app links to each of your running workspaces, not only the open one, so a command keeps running when you switch workspaces or close the window. Quitting the app, or turning a workspace’s access off, stops running commands and cuts agents off.
  • Only your workspaces. A teammate’s workspace never gets access, even in a shared environment. Anyone you let message your workspace’s agent can ask it to run commands on your computer.
  • Every computer you’re signed in on. Access follows your account, so it applies wherever the desktop app is running and signed in as you.
On macOS, the first command that reads Documents, Desktop, or Downloads makes macOS ask whether to allow Replicas. Optionally, add Replicas under System Settings → Privacy & Security → Full Disk Access so agents can work in those folders without macOS asking each time. The note after Allow links there.

Apps on your Mac

With local control on, agents can open and use apps on your Mac in the background, such as playing a track in Spotify or checking a page in Safari. Your cursor, focus, and front window stay yours, so you keep working while the agent clicks and types. Watch the window it’s working in from the Your Mac tab in the workspace sidebar, or select Open your Mac in the chat. The first time an agent drives your Mac, Replicas asks for Accessibility and Screen Recording access. Allow it later under System Settings → Privacy & Security. Agents use replicas computer mac.

Music controls

Turn on Music controls under Dashboard → Personal → Preferences → Experimental to see what’s playing at the bottom of the sidebar, with play, pause, and skip buttons. The desktop app controls the Spotify or Apple Music app on the same computer, so the app must be open there. If both are open, the sidebar shows the one that’s playing. Apple Music works on macOS only. On Windows, the sidebar shows the app in the Windows media controls, like Spotify, a video in your browser, or Media Player. On Linux, it shows any app with MPRIS media controls, like Spotify, a video in your browser, or Rhythmbox. On macOS, Replicas asks for permission the first time it controls each app. If you decline, allow it later under System Settings → Privacy & Security → Automation.

macOS turn notifications

Replicas sends a native notification when a turn finishes while the app is minimized or in the background. When the agent ends a turn asking you a question or stuck on something only you can fix, the notification says Needs your input or Agent is stuck instead of Turn finished. An agent that stops mid-turn to ask a question notifies you too, with Needs your input. 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 with Command-Shift-W keeps Replicas running so notifications can arrive. Command-W closes only the open Canvas file, plan, or other tab in a workspace. Quit Replicas with Command-Q to stop background notifications. To check that notifications reach you, select Send test under Dashboard → Personal → Preferences → Notifications. If nothing appears, select Open System Settings there and allow notifications for Replicas. Replicas also tells you in the app when macOS blocks one.

Alert sounds and priority

Pick an Alert sound under Dashboard → Personal → Preferences → Notifications. It plays in the desktop app and the browser when a workspace you aren’t looking at finishes or needs you. Choose from the Glass sounds (Glint, Tap, Ripple, Halo) or the warmer Wood sounds (Ready, Pluck, Knock, Bloom, Steps). System keeps your computer’s notification sound in the desktop app and stays silent in the browser. To change how one workspace alerts you, open its menu in the sidebar and choose Alerts:
  • Muted turns off its sounds and notifications. The sidebar still shows its status.
  • High plays Needs you from your sound’s family (Glass when you use System or None), marks its alerts High priority, keeps them on screen until you dismiss them, and bounces the Dock icon while the app is in the background.

macOS menu bar

The Replicas icon in the macOS menu bar shows how many workspaces need you, are working, and are ready to review, such as 1 needs you · 2 working. Open it to jump to any of them. It follows your active sidebar views and filters. A red dot on the Dock icon means a new notification came in while you were away, and it clears when you switch back to Replicas.

macOS notch

Turn on Show Workspaces in Notch in the Replicas menu bar menu or the View menu to keep workspace statuses at the top of your main display, including external monitors. Click the indicator to open the workspace list, then select a workspace to jump to it. Needs you appears first, and newly waiting workspaces briefly show their name without taking focus. Press Escape to close the list. The indicator hides when there are no statuses to show. Workspace names can appear over other apps, including full-screen apps, so turn the setting off before sharing your screen if you want to keep them private. 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, Windows, 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 and Windows apps and the Linux AppImage check for desktop updates automatically. When an update is ready, restart immediately or choose Later to install it the next time you open the app. With the Debian package, install new versions from this page. Web app updates appear without a desktop update.