Skip to content

Subscriptions

Source version: main.

Subscribe to events over Mach IPC, or ask Rift to run another command when an event occurs.

Subscribe to Mach IPC events.

Synopsis
rift-cli subscribe mach <EVENT>

Arguments

<EVENT>
Event to subscribe to (workspace_changed, windows_changed, window_title_changed, focused_window_changed, stacks_changed, layout_changed, selection_changed, binding_mode_changed, *).

Subscribe to events via CLI command execution.

Synopsis
rift-cli subscribe cli [OPTIONS] --event <EVENT> --command <COMMAND>

Options

--event <EVENT>
Event to subscribe to (workspace_changed, windows_changed, window_title_changed, focused_window_changed, stacks_changed, layout_changed, selection_changed, binding_mode_changed, *).
--command <COMMAND>
Command to execute when event occurs.
--args <ARGS>
Arguments to pass to command (event data will be appended as JSON).

Unsubscribe from Mach IPC events.

Synopsis
rift-cli subscribe unsub-mach <EVENT>

Arguments

<EVENT>
Event to unsubscribe from.

Unsubscribe from CLI events.

Synopsis
rift-cli subscribe unsub-cli <EVENT>

Arguments

<EVENT>
Event to unsubscribe from.

List current CLI subscriptions.

Synopsis
rift-cli subscribe list-cli