Rift

Install Rift

Install v1.3.1-alpha on your machine, then set up the projects where you want to use it.

Browse guides Installation

# Requirements

  • macOS: macOS 11 or newer, on Apple silicon or Intel.
  • Linux: x86-64 or ARM64, with glibc 2.28 or newer. Alpine/musl is not supported by these builds.
  • Windows: Windows 10 or newer on x64. Windows 11 on ARM runs the x64 build under emulation.

You need Git to set up a project, and a supported agent to capture coding sessions. You do not need administrator rights, a Rust toolchain, a database server, or a Rift account.

# Install commands

Run the command for your platform. The installer selects the build for your operating system and CPU, checks its checksum, and starts a short setup for your default agents.

macOS / Linux

sh
curl -fsS https://storage.googleapis.com/rift-e59ea04337d9/v1.3.1-alpha/install.sh | sh

Windows (PowerShell)

powershell
irm 'https://storage.googleapis.com/rift-e59ea04337d9/v1.3.1-alpha/install.ps1' | iex

These commands install v1.3.1-alpha. The alpha builds are not yet code-signed or notarised. For release details and source code, see the GitHub repository.

# After installation

terminal
rift --version
rift --help

The default location is ~/.local/bin on macOS and Linux, or %LOCALAPPDATA%\Rift\bin on Windows. The installer adds it to your PATH. If the command is not found, start a new terminal and check again.

On macOS and Linux, the installer normally opens a fresh shell so the PATH change takes effect. If you chose a custom directory or disabled PATH changes, add the chosen directory to your shell's PATH yourself.

Installation chooses defaults for future projects. Continue with the quickstart to enable Rift in a project. Run rift install later to change those defaults.

# Installer options

Set these environment variables before running the installer when you need a different setup. Use your shell's normal environment-variable syntax.

  • RIFT_BIN_DIR: choose a different installation directory.
  • RIFT_NO_MODIFY_PATH=1: leave PATH and shell startup files unchanged.
  • RIFT_NO_SHELL_RESTART=1: keep the PATH edit but do not open a new shell on macOS/Linux.
  • RIFT_NONINTERACTIVE=1: skip installer prompts for scripted installation.

Already using Rift? Read updates and uninstall for the supported update path and a preview of what uninstalling removes.