Remi CLI

Run remi in a project folder and ask for what you need. Remi reads the code, makes the change, runs the checks and tells you what it did. It asks before it changes anything, unless you tell it not to, and you can undo what it changed.

It's the same Remi as on the web, your phone and Remi Desktop. Your account, models, chats, inbox, workflows and connected apps come with you.

Before you startCopy Anchor Link

• macOS, on Apple silicon or Intel.
• Windows, on x64 or Arm64.
• Linux, on x64 or Arm64, including Alpine and other musl-based systems.
• A Remi account. Sign up on the web if you don't have one.

You don't need admin rights. Remi installs into .remi/bin in your home folder.

curl -fsSL https://remiapp.ai/install.sh | sh

irm https://remiapp.ai/install.ps1 | iex

curl -fsSL https://remiapp.ai/install.sh | sh

remi --version

remi login

cd my-project
remi

Check it workedCopy Anchor Link

remi whoami

This shows the email you're signed in with. For a fuller check, run remi doctor. It checks everything Remi depends on and tells you what to do about anything that's wrong.

Work in a folderCopy Anchor Link

Type your request and press Enter. Remi can read, search, edit and create files in the folder, and run commands there. Each change shows as it happens.

• Answer a request. When Remi wants to edit a file or run a command, it shows what and waits. Choose Yes; or yes and don't ask again for that command in this folder (for an edit, accept edits for the rest of the session); or No, and tell Remi what to do instead.
• Undo. /undo puts back the files Remi changed in its last turn.
• Stop. Press Esc to stop Remi mid-answer. Press Ctrl+C twice to quit.
• Send a file. Type @ and a path, such as @src/app.ts, to send that file with your message. To send a picture, paste it with Ctrl+V.
• Run something yourself. Start a line with !, such as ! npm test. Remi sees the output with your next message.
• Leave a note for next time. Start a line with #, such as # always use pnpm. It's added to the folder's AGENTS.md, which Remi reads in every session.
• Write more than one line. Press \ then Enter, or Alt+Enter.

Choose how much Remi does without askingCopy Anchor Link

Press Shift+Tab to move between the modes. The current mode shows under the input box.

On Windows, and on Linux without bwrap installed, there's no sandbox, so Autopilot asks before commands. To start in a mode, use remi --mode plan (or accept_edits, autopilot). Permissions has the details, and how to allow particular commands.

Commands in the appCopy Anchor Link

Type / to see them all. The ones you'll use most:

To pick up where you left off, run remi --continue for the last session in this folder, or remi --resume to choose one.

Ask once, from a scriptCopy Anchor Link

remi -p answers once and exits, for scripts and automation:

remi -p "Summarise what changed since the last release"

• For a program to read: add --output-format json for one JSON result, or --output-format stream-json for a stream of events.
• To let it act without asking: add --allow-tools with the commands it may run, such as --allow-tools "Bash(npm test:*),Edit".
• To keep it in bounds: --max-turns 5 stops after five rounds of tool calls.

To run Remi where nobody can sign in, such as CI, create a token and set it as REMI_TOKEN:

remi token create --name ci

Scripts and CI has the rest.

Pick up anywhereCopy Anchor Link

While remi is open in a folder, you can carry on that chat from your phone, the web or another computer. What you send from there runs here, in this folder, with this folder's rules. When Remi needs your permission, you can answer on your phone, but the terminal has the final say.

• /handoff opens the chat on the web or your phone.
• /host off stops taking messages from elsewhere for this session. remi --no-host starts without it.

Your Remi account in the terminalCopy Anchor Link

Use Remi from your editorCopy Anchor Link

Zed, JetBrains IDEs, Neovim and Emacs can run Remi as their AI agent, through remi acp. Your editor shows the chat, the changes and the permission requests, and Remi works in the project the editor has open. Connect your editor has the setup for each.

Update or removeCopy Anchor Link

To update, run remi update. Remi also checks for a new version once a day and tells you when there is one.

To remove it, sign out with remi logout, then delete the program:

rm ~/.remi/bin/remi

Remove-Item $HOME\.remi\bin\remi.exe

rm ~/.remi/bin/remi

Your settings are in the .remi folder in your home folder; delete it to remove them too. Your chats stay in your Remi account.

curl -fsSL https://remiapp.ai/install.sh | REMI_CHANNEL=beta sh