Skip to content

Quick Start

acsandmann edited this page Oct 20, 2025 · 11 revisions

Quick Start Guide

Tip

in order for rift to begin managing windows it must first be activated by pressing Alt + Z which is the default key combination for the toggle_space_activated

installation

homebrew

brew install acsandmann/tap/rift

once rift is installed, you can install it as a service by:

rift service install
rift service start

it will prompt you to give it accessibility permissions if you have not done so already and after it will stop itself. once you have given it permission start it again using

rift service restart

or

to just run it:

rift

build from source

git clone https://github.com/acsandmann/rift.git

once rift is installed you must build it (and the cli if you want to run it as a service)

cargo build --bins --release

now you can run it with ./target/release/rift or you can install it as a service

To install it as a service you must do

cargo run --bin rift --release service install
cargo run --bin rift --release service start

it will prompt you to give it accessibility permissions if you have not done so already and after it will stop itself. once you have given it permission start it again using

cargo run --bin rift --release service restart

now to customize you must create your own config, this is thoroughly documented here

Clone this wiki locally