RemiDocs

Remi Desktop

Remi in a window of its own on your Mac, Windows PC or Linux computer. Chat, let Remi work in a folder, dictate into any app, and ask from anywhere with Quick Ask.

Coming soon

Remi Desktop isn’t out yet. Until it is, use Remi on the web: it has the same chats and documents.

What it does

  • Your chats, in their own window. The chats, projects and documents from the web, in an app you can keep open beside your work.
  • Remi in a folder. Choose a folder and Remi can read, search and edit its files, and run commands there. It asks before it changes anything, unless you choose a mode that lets it. You can keep or undo each change.
  • Hold to talk. Hold a key in any app, speak, and let go. Remi writes what you said where your cursor is.
  • Quick Ask. Press a key in any app, type a question, and Remi answers in a new chat.

Before you start

  • Mac: macOS 12 or later, on Apple silicon or Intel.
  • Windows: Windows 10 or later, 64-bit.
  • Linux: a 64-bit computer. Remi Desktop comes as an AppImage, and as a .deb for Debian and Ubuntu.
  • A Remi account. Sign up on the web if you don't have one. Without one, you can still work in a folder, with a model on your computer or your own API key.
  • A microphone, if you want to use hold to talk.

Download and install

  1. Go to remiapp.ai/download and select Download for Mac.
  2. Open the file you downloaded, and drag Remi into your Applications folder.
  3. Open Remi from Applications.

If macOS says it can't check Remi for malicious software, see Find your error.

Sign in

Open Remi Desktop and select Sign in.

Select Continue in your browser. Remi opens remiapp.ai, where you're probably signed in already.

Check that the page shows the same code as the app, then select Approve.

You can also enter your email in the app and type the 6-digit code Remi emails you. Passkeys don't work in Remi Desktop yet: use your authenticator app or a recovery code instead.

Check it worked

The chats you started on the web appear in the sidebar.

Work in a folder

  1. Select Work in a folder, or press ⇧⌘N on a Mac (Ctrl+Shift+N on Windows and Linux).
  2. Select Choose a folder… and pick the folder.
  3. Ask Remi to do something there.

When Remi wants to change a file or run a command, it shows you what it wants to do and waits. Allow it, say no, or tell Remi what to do instead. Each file Remi changed has Keep and Undo, and Keep all and Undo all cover every file at once.

Choose how much Remi does without asking

Each folder session has a Mode menu. ⇧⌘M (Ctrl+Shift+M) switches to the next mode.

ModeWhat Remi does without asking
Ask firstReads and searches. It asks before it edits a file or runs a command.
Edit freelyEdits files. Commands still need your OK.
Plan onlyReads and plans, but doesn't change anything.
AutopilotEdits files, and runs commands in a sandbox that can only change this folder. It still asks before deleting, installing software, signing in, or pushing and publishing.

New sessions start in Ask first. To change that, go to Settings › Models and permissions and choose under New sessions start in.

Autopilot is in the Mode menu once you turn on Allow Autopilot in Settings › Models and permissions. On Windows, and on Linux without bubblewrap (bwrap) installed, there's no sandbox, so Autopilot asks before each command. What Autopilot always asks about in Remi Desktop has the full list.

Choose the model for folder sessions

In Settings › Models and permissions, Model for folder sessions offers:

  • Remi (your account): Remi's models, through the account you signed in with.
  • On this computer: Ollama, LM Studio or another OpenAI-compatible server.
  • Anthropic: Claude models, with your own API key. The key goes into your system keychain.

Hold to talk

  1. Put your cursor where you want the words, such as an email or a document, in any app.
  2. Hold ⌃⌥Space on a Mac, or Ctrl+Alt+Space on Windows and Linux, and speak. A small indicator shows while Remi is listening.
  3. Let go. Remi writes what you said where your cursor is.

Press Esc while Remi is listening to cancel. To paste your last dictation again, press ⌃⌘V on a Mac, or Ctrl+Alt+Shift+V on Windows and Linux.

Dictation needs you signed in: what you say goes through your Remi account to be written down. The first time on a Mac, Remi asks for Microphone access, and for Accessibility so it can paste for you. Without Accessibility, Remi copies the text and you paste it.

If another app already uses the key, Settings says so. The mic in Remi's own message box still works: select it, or press ⌘D (Ctrl+D).

Settings › Voice has the rest:

  • Tidy what you say: As I said it, Everyday (the default), Formal or Technical, which keeps file names, commands and symbols as you said them.
  • Your words: names and terms Remi spells your way.
  • Snippets: say a phrase of two words or more, and Remi puts in the text you saved for it.
  • Type into other apps: on unless you turn it off. Off, Remi copies the text for you to paste.
  • Also keep each dictation as a note: off unless you turn it on. Notes stay on this computer.
  • Indicator: a bar, an orb or a dot, and where it sits on your screen.

Quick Ask

Press ⌥Space on a Mac, or Alt+Space on Windows and Linux, in any app. Type your question and press Enter: Remi opens a new chat with it in its main window. Press Esc to close the box.

You can also choose Quick Ask from Remi's icon in the menu bar or system tray. If another app already uses the key, the menu item still works.

Keyboard shortcuts

Keyboard shortcuts lists every Remi Desktop shortcut, with the Mac keys and the Windows and Linux keys.

Update or remove

To update, download the latest version from remiapp.ai/download and install it as before.

To remove Remi Desktop:

  • Mac: quit Remi, then drag it from Applications to the Bin.
  • Windows: in Settings › Apps, find Remi and uninstall it.
  • Linux: delete the AppImage, or remove the package with apt.

Your chats stay in your Remi account.

Coming from the CLI?

Remi Desktop and the Remi CLI use the same account and workspace. A terminal session stays in the CLI and a folder session in Remi Desktop, so use whichever suits the job.

On this page