Agent Instructions for Hyprtron

This repository contains configuration files for a Wayland/Hyprland desktop setup.

Workflow & File Structure

Edit repo files only: Files in ./config/ map to ~/.config/ and ./local/ map to ~/.local/. Modify files in this repo; never attempt to modify live files directly in the user's home directory.
There are no tests, builds, or dev servers. Treat this as a pure dotfiles structure.

Daemon startup via UWSM: Background services and daemons (e.g., waybar, hyprpaper, hypridle, walker, swayosd-server) are launched using uwsm (Universal Wayland Session Manager). When adding new startups to hyprland.conf, use exec-once = uwsm app -- <command> rather than bare exec-once.
Keybindings: Application bindings are in config/hypr/bindings.conf. Use bindd to include descriptions instead of the standard bind (e.g., bindd = $mainMod, KEY, Description, exec, command).
External scripts: The user's PATH includes ~/.local/share/omarchy/bin (configured via config/uwsm/env). Commands like omarchy-launch-webapp are external to this repository.

The global CSS theme variables are located at local/share/hyprtron/theme/style.css.
Hardcoded duplication: Currently, most tools do not import the shared theme file (only walker does). Configs for swaync, swayosd, waybar, hyprlock.conf, and hyprland.conf hardcode the colors (e.g., background rgba(26, 27, 38, ...), border #33ccff).
When changing colors: You must grep and manually update the hardcoded hex/rgba/rgb values across all .css and .conf files. Do not assume updating local/share/hyprtron/theme/style.css is sufficient.