# AGENTS.md — niri config

## Structure

- **`config.kdl`** — main niri compositor config (KDL format, https://kdl.dev). Includes `dms/*.kdl` at the bottom.
- **`dms/`** — sub-configs, split by concern. Several are auto-generated by DMS (external tool) and **must not be edited** directly:

  | File | Editable? |
  |---|---|
  | `layout.kdl`, `cursor.kdl`, `wpblur.kdl`, `alttab.kdl`, `colors.kdl` | No — auto-generated by DMS, note says changes will be overwritten |
  | `outputs.kdl` | Yes — monitor layout (manually maintained despite auto-gen header) |
  | `binds.kdl`, `windowrules.kdl` | Yes — empty, available for custom keybinds/window rules |

- **`config.kdl.backup*`** — historical snapshots, not active configs.

## Keybindings (subset referenced in config)

| Keys | Action |
|---|---|
| Mod+E | `thunar` (file manager) |
| Mod+D | `rofi -show drun` (app launcher) |
| Mod+T | `kitty` (terminal) |
| Mod+B | `firefox` (browser) |
| Super+Alt+L | `swaylock` (screen locker) |

(Mod = Super on TTY, Alt on winit window.)

## Key tools

- **niri** — Wayland compositor. Runtime queries: `niri msg outputs`, `niri msg action <action>`.
- **DMS** — external config manager that re-generates auto files in `dms/`.
- **Audio:** PipeWire + WirePlumber (`wpctl`). **Media keys:** `playerctl` (MPRIS). **Brightness:** `brightnessctl`.

## Conventions

- Do not edit auto-generated DMS files. Edit `config.kdl`, `dms/outputs.kdl`, `dms/binds.kdl`, or `dms/windowrules.kdl` instead.
- After config changes, restart niri or use `niri msg` to apply per-action.

## 项目规定

- 使用中文交流。
- 构建完毕后，按功能将修改拆分提交（一次提交只对应一个目的）。
- 远程仓库：`git@git.sugarsource.club:Akn/nirion.git`，提交完后执行 `git push`。