Skip to content

Plugins

Companion tools run alongside Rift and communicate through its terminal tool or IPC (inter-process communication). They are installed separately. Check each project’s supported Rift version before installing or upgrading it.

Project What it does
rift-container-highlighter Outlines nested window groups so you can see what a group command will affect
Rift App Indicator Shows application icons grouped by workspace in the macOS menu bar
rift-ergo Adds commands for moving windows and workspaces between displays; requires adapting its personal routing setup
rift-pip Mirrors the focused window in a picture-in-picture window

The highlighter is useful with Traditional and BSP, where the grouping is otherwise hard to see. Rift App Indicator’s repository is named rift-companian; its executable is rift-app-indicator.

  • rift.lua: Lua client for Rift’s IPC interface.
  • riftapi: Lua helpers for workspaces, windows, layouts, displays, and events, built on rift.lua.

See Integrations to write your own scripts.

Open an issue with the project URL, its purpose, supported Rift version, and installation requirements.