swaymsg

Send command

$ swaymsg [command]

$ swaymsg -t get_workspaces

$ swaymsg -t get_outputs

$ swaymsg -t get_tree | jq '.. | select(.focused?)'

$ swaymsg reload

$ swaymsg exit

$ swaymsg move workspace to output [HDMI-A-1]

swaymsg [-t type] [-m] [options] message

swaymsg communicates with Sway window manager. It sends commands and queries state.
Commands control window management. Move, resize, focus operations.
Get queries return JSON data. Parse with jq for specific info.
Monitor mode watches events. See changes in real-time.
Socket path defaults to SWAYSOCK. Override for specific instance.

-t, --type TYPE

Message type.

Monitor for responses.

Raw output.

Quiet mode.

Socket path.

get_workspaces - List workspaces
get_outputs - List outputs
get_tree - Window tree
get_marks - Window marks
get_bar_config - Bar config
get_version - Sway version

Sway must be running. Socket permissions required. JSON output needs parsing.

swaymsg is the IPC client for Sway compositor. It mirrors i3-msg functionality for Wayland.

sway(1), jq(1), i3-msg(1)