aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-13 09:57:22 +0200
committerDanilo M. <danix@danix.xyz>2026-10-13 09:57:22 +0200
commit9de89ae1512928283c1de7360e0313e1e2975b47 (patch)
treef6d2e8263580096e76e76dcd8c6b6bcfeaacf687 /AGENTS.md
parentc635798c7e782af84ba1cf592e93619376a93d8a (diff)
downloadquickshell-9de89ae1512928283c1de7360e0313e1e2975b47.tar.gz
quickshell-9de89ae1512928283c1de7360e0313e1e2975b47.zip
docs: the controls panel, its preferences file and bind
The island README gains the panel. AGENTS.md records that a bare SUPER release bind is cancelled by drag and scroll on Hyprland 0.56.2, which was the open risk in the spec, and that FileView creates parent directories while Quickshell.stateDir is per-shell. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md12
1 files changed, 11 insertions, 1 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 2d7c950..82b73e0 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -12,7 +12,8 @@ running one does not require the others. `desktop/` is itself a host for
modules.
desktop/ the drawer: sound, mail, VMs, appearance
- island/ top-centre pills on DP-1: clock, volume, tray, layout, privacy
+ island/ top-centre pills on DP-1: clock, volume, tray, layout, privacy,
+ controls panel (SUPER alone)
appearance/ wallpaper picker and colour scheme switcher
window-switcher/ open windows as live previews in a grid, on ALT+TAB
keybinds/ live keybind reminder, on SUPER+k
@@ -145,6 +146,15 @@ changing that component. The ones that generalise:
- **`hyprctl switchxkblayout current next|prev` targets the main keyboard**, so
no device lookup is needed. Hyprland's `activelayout` raw event fires on
every switch, so the layout flag is event-driven rather than polled.
+- **A bare-modifier release bind works on Hyprland 0.56.2.** `hl.bind("SUPER
+ + Super_L", ..., { release = true })` fires on SUPER pressed and released
+ alone, and is cancelled by any key in between and by `SUPER`+drag and
+ `SUPER`+scroll; all checked by hand. That is how SUPER alone opens the
+ island's controls panel.
+- **`FileView.setText` creates missing parent directories**, so `Prefs.qml`
+ has no mkdir step. `Quickshell.stateDir` is a per-shell hashed directory
+ (`by-shell/<hash>`), not `~/.local/state/quickshell`, which is why the
+ preferences path is built from `XDG_STATE_HOME` instead.
- **Waybar is gone, both bars.** Its DP-3 functions moved to the island. The
mail count is drawer-only: `Accounts.qml` watches the xapian directory
itself, and `waybar-mail.sh` was deleted.