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 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.
---
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.