diff options
| author | Nick Moore <nicholasvmoore@gmail.com> | 2026-11-07 09:20:22 -0600 |
|---|---|---|
| committer | Nick Moore <nicholasvmoore@gmail.com> | 2026-11-07 09:20:22 -0600 |
| commit | 6c4039aebbe7ec25f47cb4623e44b96373e9e6e5 (patch) | |
| tree | 6b29ac15408e586c41d6bc91561294709c87a962 /sway/AGENTS.md | |
| parent | 34abcb44caf7266ce40063daca05a2a06f1b26c7 (diff) | |
Track sway (shared + rigel machine overlay), replace fibonacci with dwm-dwindle listener
- sway package: shared config (styling, all muscle-memory binds, no exec
lines) including ~/.config/sway/machines/*.conf overlays included LAST;
floating_windows + machines/README contract; sway/AGENTS.md doctrine
- rigel package: machine overlay (outputs, touchpad, session stack, power
bindings) + session scripts now stow-managed; fibonacci.py replaced by
a POSIX sh+jq dwindle listener (dwm dwindle geometry, --monitor
subscription, mark+move re-home, flock singleton); machines/rigel.conf
exec line updated to the new path
- validated in a headless nested sway against a literal port of
fibonacci.c: five- and seven-window trees plus refocus-before-spawn
all match dwm's rects (modulo the bar offset)
Diffstat (limited to 'sway/AGENTS.md')
| -rw-r--r-- | sway/AGENTS.md | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/sway/AGENTS.md b/sway/AGENTS.md new file mode 100644 index 0000000..bb5532e --- /dev/null +++ b/sway/AGENTS.md @@ -0,0 +1,33 @@ +# sway — Component Context + +Parent rules: `../AGENTS.md` (repo root). This package holds the SHARED +sway config for every sway-using machine. + +## The split doctrine + +- Tracked `config` = shared, machine-agnostic layer: doom-one palette + variables, fonts, borders/gaps/titlebars, window rules, ALL muscle-memory + key bindings (vim motions, workspaces, screenshots, volume/media/ + brightness, resize mode), behavioral QoL. NO exec lines, no machine + paths, no output names. +- Machine overlays: `~/.config/sway/machines/<hostname>.conf`, included + LAST — they may override anything above and may ONLY contain hardware + shape (outputs, input blocks), that machine's session stack (autostart + of its own scripts), lock/idle, and power behavior. NEVER styling. In + this repo the pattern is delivered by per-machine packages (currently + `../rigel`); see `machines/README.md` for the contract. +- Sway precedence facts the split relies on: specific `output <name>` + rules beat `output *`; later bindsym definitions win; `include` is + re-evaluated on every `swaymsg reload`. + +## Include depth constraint + +Sway's include is one level deep: `machines/*.conf` files are included +directly by the main config and must NOT themselves contain `include`. + +## Session scripts + +Referenced autostart scripts are per-machine repo content (rigel package +ships its supervisor/fibonacci/ppd/veila helpers). The shared config +contains no exec lines, so a bare `stow sway` on a new machine yields a +working, safe desktop before that machine's overlay lands. |
