--- name: niri os: lnx description: "Use for configuring or diagnosing niri Wayland compositor: KDL config, niri msg IPC, outputs, bindings, window rules, and runtime behavior." license: MIT --- # niri - Inspect installed `niri --help`, `niri validate --help`, and version before relying on command syntax or config support. - Read the current [niri documentation](https://niri-wm.github.io/niri/) for exact config options, defaults, and IPC actions; do not rely on copied option tables or examples. - Inspect existing config and included files before editing; make the smallest authorized KDL change, preserve rollback, then run `niri validate` when available. - Use `niri msg` for read-only runtime inspection; treat `niri msg action` as state-changing and run only when requested. - Never execute `niri-session` for inspection or testing; it may terminate the active desktop session. Start it only when explicitly requested. - Confirm the active niri version/config behavior before diagnosing reload or IPC mismatches; avoid restarting or quitting the compositor unless requested.