nixos-awesomewm

Work with Cairo surfaces, custom widget drawing, and theme asset generation in this AwesomeWM config. Use when creating painted surfaces, custom widget :draw() methods, gradient backgrounds, icon recoloring, shape functions, or cropping/transforming images.

Add and maintain keyboard shortcuts in the AwesomeWM config at /etc/nixos/external/awesome. Use when adding a new keybinding, modifying an existing one, or debugging dual-bind/keyd throttle issues.

Create AwesomeWM popup components with this codebase's singleton, gobject, and OSD patterns. Use when adding a popup, wiring mutual-exclusion, or implementing control panel applets.

Create or modify AwesomeWM system service modules (audio, battery, network, bluetooth, etc.) following codebase conventions. Use when building a new service, refactoring an existing one, or debugging service patterns.

Test AwesomeWM config changes using Xephyr nested sessions. Use when testing configuration changes, debugging runtime errors, or validating syntax before reloading.