docs: rebuild KB in OKF v0.1 with live-verified facts
Copy of the legacy ~/.pi/agent/docs tree rebuilt as the command-center knowledge base: concept files promoted to path identity, index listings stripped of frontmatter, all wikilinks/relative links resolved, every checkable claim verified against the live fleet (Dankserver = Ryzen 7 7700X + RTX 3090; Strix Halo is Dankclaw), unverifiable claims tagged. kb-lint exits 0.
This commit is contained in:
1 parent
552d1ef8bf
commit
02883d3ed2
116 files changed
+13008
No files matched your search
@@ -0,0 +1,60 @@
|
||||
---
|
||||
type: reference
|
||||
title: Niri Key Bindings Syntax
|
||||
description: Configuration syntax for niri key bindings — KDL format, modifiers, bind options, and finding key names with wev.
|
||||
tags:
|
||||
- niri
|
||||
- keybindings
|
||||
- kdl
|
||||
- configuration
|
||||
verified: 2026-08-28
|
||||
---
|
||||
|
||||
# Key Bindings Syntax
|
||||
|
||||
Key bindings go in the `binds {}` section of the config file (`~/.config/niri/config.kdl`):
|
||||
|
||||
```kdl
|
||||
binds {
|
||||
Mod+T { spawn "alacritty"; }
|
||||
Mod+Left { focus-column-left; }
|
||||
}
|
||||
```
|
||||
|
||||
## Modifiers
|
||||
|
||||
- `Ctrl` or `Control`
|
||||
- `Shift`
|
||||
- `Alt`
|
||||
- `Super` or `Win`
|
||||
- `ISO_Level3_Shift` or `Mod5` (AltGr)
|
||||
- `ISO_Level5_Shift` (for lv5 options like `lv5:caps_switch`)
|
||||
- `Mod` — Special: equals `Super` on TTY, equals `Alt` in nested window
|
||||
|
||||
## Bind Options
|
||||
|
||||
```kdl
|
||||
binds {
|
||||
Mod+T repeat=false { spawn "alacritty"; } // Do not repeat on hold
|
||||
Mod+T cooldown-ms=500 { spawn "alacritty"; } // Rate-limit
|
||||
Super+Alt+L allow-when-locked=true { spawn "swaylock"; } // Works when locked
|
||||
Mod+Q hotkey-overlay-title="Close Window" { close-window; } // Custom title in overlay
|
||||
Mod+Escape allow-inhibiting=false { ... } // Always works (even with inhibitors)
|
||||
}
|
||||
```
|
||||
|
||||
## Finding Key Names
|
||||
|
||||
Use [`wev`](https://git.sr.ht/~sircmpwn/wev) to find XKB key names:
|
||||
|
||||
```bash
|
||||
wev
|
||||
# Then press the key you want to bind — look at `sym: XXXX` in output
|
||||
```
|
||||
|
||||
Shifted keys require Shift + the unshifted key (for example, `Mod+Shift+Comma` for `<` on US QWERTY).
|
||||
|
||||
## Related
|
||||
|
||||
* [Default Key Bindings](/tools/niri/default-bindings.md) — What niri ships with out of the box
|
||||
* [Action Reference](/tools/niri/action-reference.md) — All available actions
|
||||
Reference in new issue
Block a user