diff options
| -rw-r--r-- | README.md | 33 |
1 files changed, 32 insertions, 1 deletions
@@ -1 +1,32 @@ -# dotfiles
\ No newline at end of file +# dotfiles + +Personal configuration, deployed as GNU stow packages. Each top-level +directory is a package that mirrors `$HOME`, e.g. +`waybar/.config/waybar/config.jsonc`. + +Machines currently represented: + +- **rigel** — Gentoo + sway laptop (waybar, tmux, nvim, alacritty are + synced from here; sway/ is pending) +- **hypr** — Hyprland machines (hypr/ package) + +## Deploy (GNU stow) + +```sh +git clone git.pcola.moorenix.com:git-public/dotfiles.git ~/git/dotfiles +cd ~/git/dotfiles + +# see what would change first (-n = dry run): +stow -n -v2 -t ~ waybar + +# stow for real; --adopt moves any existing target file into the package +# and replaces it with a symlink (converts a live config to stow-managed): +stow --adopt -t ~ waybar tmux nvim alacritty + +# sway: swaymsg reload after stow config changes +``` + +Not every package fits every machine — pick the ones matching that +machine's stack. Per-tool conventions live in each package's `AGENTS.md`; +repo-wide rules (secrets, hygiene, layout invariants) in the root +`AGENTS.md`. |
