neoromantique-dotfiles/AGENTS.md

AGENTS Guide: Dotfiles Repository

Chezmoi-managed dotfiles with device-adaptive templates. Source files in ~/dotfiles/, deployed to ~/ via chezmoi apply.

Device Profiles

Profile	Hostname	Primary Monitor	Has Touchpad	Has Battery
desktop	box	DP-2	No	No
laptop	bluefin	eDP-1	Yes	Yes

Template Variables

{{ .deviceProfile }}   // "desktop" or "laptop"
{{ .hostname }}        // "box" or "bluefin"
{{ .primaryMonitor }}  // "DP-2" or "eDP-1"
{{ .hasTouchpad }}     // boolean
{{ .hasBattery }}      // boolean
{{ .idleTimeout }}     // 300 (desktop) or 180 (laptop)
{{ .secretsPath }}     // "~/secrets"

File Naming Conventions

Pattern	Effect
private_dot_*	Hidden file with 700 permissions
dot_*	Hidden file with 755 permissions
executable_*	Executable (755)
*.tmpl	Processed as Go template

Directory Structure

home/
├── private_dot_config/     # ~/.config/
│   ├── hypr/               # Hyprland configs
│   ├── fish/               # Shell
│   ├── waybar/             # Status bar
│   └── ghostty/            # Terminal
├── dot_local/bin/          # ~/.local/bin/ scripts
└── .chezmoiscripts/        # One-time setup scripts

Hyprland Config Files

All in home/private_dot_config/hypr/:

File	Purpose
hyprland.conf.tmpl	Main config, keybindings, window rules
monitors.conf.tmpl	Monitor setup
autostart.conf.tmpl	Startup applications
colors.conf	Color palette
workspaces.conf	Workspace definitions
hyprpaper.conf.tmpl	Wallpaper
hypridle.conf.tmpl	Idle/power management
hyprlock.conf	Lock screen

Template Conditionals

{{- if eq .deviceProfile "desktop" }}
# Desktop only
{{- else if eq .deviceProfile "laptop" }}
# Laptop only
{{- end }}

{{- if .hasBattery }}
# Battery-dependent (laptop brightness keys, etc.)
{{- end }}

{{- if .hasTouchpad }}
# Touchpad settings
{{- end }}

Key Commands

chezmoi apply          # Deploy changes
chezmoi diff           # Preview changes
chezmoi edit <file>    # Edit managed file
chezmoi add <file>     # Add new file to management

Standards

• Scripts: #!/usr/bin/env bash with set -euo pipefail
• Secrets: Store in ~/secrets/, reference via {{ .secretsPath }}
• Window rules: Use windowrulev2 (not deprecated windowrule)
• Whitespace: Use {{- to trim in templates