Getting started

Install Rip, open a folder, and learn the parts of the window.

Rip is a code editor for people who review more code than they write. This page takes you from the download to your first open folder.

Install#

macOS#

1. Download Rip from ripeditor.com. Pick Apple Silicon or Intel.
2. Open the disk image and drag Rip into Applications.
3. Open Rip from Applications.

Rip needs macOS 12 or later.

Linux#

Rip ships as a package for Debian, Ubuntu, Fedora and Arch Linux, and as a tarball for other distributions. The Linux download page has one command for each. The package is rip-editor; the command it installs is rip.

Windows#

Run the Windows x64 installer. It installs Rip for your user and adds a Start menu shortcut. Keep Add Rip to your terminal PATH selected to use rip from a new terminal window. You do not need an administrator account.

The portable ZIP contains rip.exe and rip.com. Keep them together. Open rip.exe to start the editor, or run rip.com from a terminal. Rip needs Windows 10 version 1809 or later and a Direct3D 11 compatible graphics device.

Set up the terminal command#

After you open Rip on macOS or Linux, install the terminal command. It lets you open files and folders from your shell. Linux packages already provide rip; skip this step if the command already works.

1. In Rip, press PCtrl+Shift+P to open the command palette.
2. Type Install rip Terminal Command and press ↩Enter.
3. Open a new terminal window.
4. Run rip . to open the current folder, or rip path/to/file to open a file. Quote paths that contain spaces: rip "my project".

The command opens files and folders in the running Rip and returns to your shell. Open files keep their unsaved changes. A folder reuses its project window or opens a new window in the same app. Run rip without paths to bring Rip forward. If Rip is not running, the command starts it.

Use rip --foreground when starting Rip to keep the editor attached to the terminal and show diagnostic output until it closes. If Rip is already running, the command forwards your paths and returns.

Rip creates a launcher at ~/.local/bin/rip and adds that folder to PATH in your shell startup files. It supports zsh, bash, and fish. It keeps existing unrelated files at the launcher path.

The launcher points to the current application. On macOS, move Rip to Applications before installing the command. If you move Rip later, run the install command again.

Open a folder#

Rip shows one folder per window.

Start rip without a path to open an empty window.

• Press OCtrl+O and pick a folder.
• After you set up the terminal command, run rip path/to/folder in a terminal.
• Open a file the same way. Rip opens it in the current window without changing the project folder.
• With rip path/to/file, Rip opens the file with its folder as the project.

The window#

• Sidebar. The file tree of the open folder. BCtrl+B hides and shows it. A file that changed on disk while you looked elsewhere gets a dot.
• Tabs and panes. Each file opens in a tab. \Ctrl+\ splits the editor into two panes.
• Status bar. The branch and worktree, with buttons for the change review, pull requests, worktrees and file history. On the right: the cursor position, the indentation, and the language.
• Title bar. The folder and the current file.
• Menu bar. On Linux and Windows, Rip shows its menus below the title bar. On macOS, use the system menu bar.

On Linux and Windows, press F10F10 to open the File menu. Use the arrow keys to move through menus and commands. Press ↩Enter to run a command or ⎋Esc to close the menu. You can also open File, Edit, View, Git, or Help with FAlt+F, EAlt+E, VAlt+V, GAlt+G, or HAlt+H.

First keys#

Next#

• Push and pull explains remote selection and branch updates.
• Stage and commit explains how to commit selected files or hunks.
• Configuration explains the template settings and their defaults.
• Keyboard shortcuts lists every binding and shows how to change one.