Skip to content

Window commands

Source version: main.

Window management commands. All commands act on the running Rift instance.

Focus the next window.

Synopsis
rift-cli execute window next

Focus the previous window.

Synopsis
rift-cli execute window prev

Focus a window by direction or by a specific window ID.

Synopsis
rift-cli execute window focus [OPTIONS] [DIRECTION]

Arguments

[DIRECTION]
Direction to focus (left, right, up, down).

Options

--window-id <WINDOW_ID>
Rift window ID as JSON ({"pid":123,"idx":456}) or debug text.
--window-server-id <WINDOW_SERVER_ID>
Optional macOS window server ID for the target window.

Toggle window floating state.

Synopsis
rift-cli execute window toggle-float

Toggle fullscreen mode (fills the whole screen, ignores outer gaps).

Synopsis
rift-cli execute window toggle-fullscreen

Toggle fullscreen within configured outer gaps (respects outer gaps / fills tiling area).

Synopsis
rift-cli execute window toggle-fullscreen-within-gaps

Grow the current window size (increments by ~5%).

Synopsis
rift-cli execute window resize-grow [OPTIONS]

Options

--orientation <ORIENTATION>
Axis to resize; smart chooses the nearest applicable split. Default: horizontal. Accepted values: horizontal, vertical, smart.

Shrink the current window size (decrements by ~5%).

Synopsis
rift-cli execute window resize-shrink [OPTIONS]

Options

--orientation <ORIENTATION>
Axis to resize; smart chooses the nearest applicable split. Default: horizontal. Accepted values: horizontal, vertical, smart.

Resize the selected window by a fractional amount. Pass a signed floating value: positive to grow, negative to shrink. The value is a fraction of the current size (e.g. 0.05 = 5%).

Synopsis
rift-cli execute window resize-by --amount <AMOUNT>

Options

--amount <AMOUNT>

Close a window as if Command-W was pressed.

Synopsis
rift-cli execute window close [OPTIONS]

Options

--window-id <WINDOW_ID>
Optional window server ID; defaults to the focused window [aliases: --window-server-id].