Files
dotfiles/AGENTS.md
s0wlz (Matthias Puchstein) 8018b53353 feat: finalize migration to chezmoi and modernize configuration logic
- Modularize Hyprland config into hyprland.d/
- Implement infinitely scalable monitor/workspace logic using templates and loop-based data structures
- Consolidate host-specific configs (hyprlock, hyprpaper, waybar) into single templates
- Resolve waybar symlink conflict and fix template execution errors
- Integrate chezmoi data variables for scale, resolution, and peripherals
2025-12-27 22:52:43 +01:00

2.0 KiB
Raw Blame History

Repository Guidelines

Project Structure & Module Organization

This is a chezmoi dotfiles source tree. Key paths:

  • dot_config/ maps to ~/.config/ (e.g., dot_config/hypr/, dot_config/nvim/, dot_config/waybar/).
  • dot_local/ maps to ~/.local/ (app data, scripts, etc.).
  • dot_profile.tmpl renders to ~/.profile.
  • .chezmoiscripts/ contains chezmoi hooks (e.g., run_onchange_* scripts).
  • Host-specific variants use ##hostname.<name> (e.g., hyprpaper.conf##hostname.owlenlap01).
  • dot_config/waybar/waybar.wiki/ and dot_config/hypr/hyprland.wiki/ are mirrored docs with dot_git/ metadata; treat them as upstream mirrors unless intentionally updating.

Build, Test, and Development Commands

There is no build system; apply and verify changes with chezmoi:

  • chezmoi diff preview pending changes.
  • chezmoi apply render and apply to $HOME.
  • chezmoi status show managed file status. After applying, restart the affected app (e.g., reload Hyprland/Waybar) to validate.

Coding Style & Naming Conventions

  • Match the existing files formatting; dont reflow unrelated sections.
  • Lua configs in dot_config/nvim/ use 2space indents and include dot_config/nvim/dot_stylua.toml and dot_config/nvim/selene.toml for format/lint settings.
  • Use chezmoi prefixes: dot_ for dotfiles, executable_ for executable files, symlink_ for symlinks, private_ for restrictedpermission files, and .tmpl for Go templates.

Testing Guidelines

No automated tests are defined. Validate by:

  • Running chezmoi diff and chezmoi apply.
  • Smoketesting the specific tool you changed (e.g., open Neovim, restart Waybar, reload Hyprland).

Commit & Pull Request Guidelines

This repository has no commits yet, so there is no established commit message convention. Use short, imperative subjects and include a scope when helpful (e.g., hypr: adjust keybinds). For PRs, include a clear summary, affected paths, and screenshots for visual/UI changes.