docs(niri): fold AGENTS.md overwrite into niri KB section

The working tree had replaced the operating contract in AGENTS.md with a
niri config-reload + keybinding-constraints note. Content relocated to its
proper home: tips.md 3-config-reload (SIGHUP footgun, load-config-file) and
key-bindings-syntax.md constraints section. AGENTS.md restored from HEAD.
This commit is contained in:
Frank committed 2026-09-09 16:19:02 -07:00
1 parent 898519712b
commit ac1608e71f
2 files changed
+14 -1

No files matched your search

+8 -1
View File
@@ -21,7 +21,14 @@ Use `Mod` instead of `Super` for configs that work both on TTY and in nested win
## 3. Config reload
niri supports live-reloading config without restart.
**Do NOT send `SIGHUP` to the niri process** (`kill -s SIGHUP $(pgrep -f 'niri --session')`) — it causes a full session logout/restart instead of a live config reload.
Correct reload options, in order of preference:
- `niri msg action load-config-file` — live reload without disrupting the session (preferred).
- Log out and back in (safe, guaranteed clean reload).
- Let the user decide when to reload; agents should modify config files without auto-reloading.
Niri reads `~/.config/niri/config.kdl` (or `config.kdl` relative to its CWD). Split config lives in `~/.config/niri/cfg/` — each `.kdl` file is `include`d from the main config, so a reload picks up edits to any included module.
## 4. Alternative navigation