Seven files deployed by this repository still sit at the root of $HOME. Three of them have a
documented XDG destination; the other four do not, and should stay where they are.
Evidence
grep '^~/\.' Makefile, then per-tool verification. macOS 15 (Darwin 25.5.0), arm64.
| Deployed at |
Declared |
XDG destination |
Status |
~/.tmux.conf |
Makefile:716 |
~/.config/tmux/tmux.conf |
Verified here. man tmux on tmux 3.7b lists it explicitly: $XDG_CONFIG_HOME/tmux/tmux.conf / ~/.config/tmux/tmux.conf. |
~/.wezterm.lua |
Makefile:146 |
~/.config/wezterm/wezterm.lua |
Documented upstream. Not verified on this machine. |
~/.gitconfig.delta |
Makefile:694 |
~/.config/git/ |
Git reads ~/.config/git/config; the include.path set at Makefile:696-699 would follow. |
~/.psqlrc |
Makefile:319 |
— |
No XDG support; only the PSQLRC environment variable. Leave. |
~/.zshrc |
Makefile:688 |
— |
Requires ZDOTDIR, which has to be set before the shell reads anything. Not worth it for a 6-line file whose first comment says zsh is not the primary shell. Leave. |
~/cspell.json |
Makefile:663 |
— |
Not verified. cspell's global-configuration lookup was not established; do not move it on an assumption. |
~/.fzf |
Makefile:675 |
— |
An installation directory, not configuration. Leave. |
Measured gain: three files. That is the whole of it, and it is stated here so the size of the
prize is not overestimated later.
Fix
Do it opportunistically, not as a campaign — move ~/.tmux.conf the next time the tmux
configuration is touched for another reason, and the other two likewise. Each move is: change the
target path in the Makefile, add the parent mkdir -p rule, and remove the stale link by hand on
this machine (the Makefile never deletes, by design — see the "never overwrite a destination"
constraint in .agents/skills/dotfiles/SKILL.md).
~/cspell.json carries a second oddity worth checking in the same pass: cspell.json:1 hardcodes
~/.dotfiles/dict/user.txt as a dictionary path, and whether ~ is expanded there was not verified.
Verification
Per file: remove the old link, run the target, and confirm the tool reads the new location —
tmux kill-server; tmux new -d; tmux show-options -g prefix must return C-a, which only the
repository's configuration sets.
Seven files deployed by this repository still sit at the root of
$HOME. Three of them have adocumented XDG destination; the other four do not, and should stay where they are.
Evidence
grep '^~/\.' Makefile, then per-tool verification. macOS 15 (Darwin 25.5.0), arm64.~/.tmux.confMakefile:716~/.config/tmux/tmux.confman tmuxon tmux 3.7b lists it explicitly:$XDG_CONFIG_HOME/tmux/tmux.conf/~/.config/tmux/tmux.conf.~/.wezterm.luaMakefile:146~/.config/wezterm/wezterm.lua~/.gitconfig.deltaMakefile:694~/.config/git/~/.config/git/config; theinclude.pathset atMakefile:696-699would follow.~/.psqlrcMakefile:319PSQLRCenvironment variable. Leave.~/.zshrcMakefile:688ZDOTDIR, which has to be set before the shell reads anything. Not worth it for a 6-line file whose first comment says zsh is not the primary shell. Leave.~/cspell.jsonMakefile:663~/.fzfMakefile:675Measured gain: three files. That is the whole of it, and it is stated here so the size of the
prize is not overestimated later.
Fix
Do it opportunistically, not as a campaign — move
~/.tmux.confthe next time the tmuxconfiguration is touched for another reason, and the other two likewise. Each move is: change the
target path in the
Makefile, add the parentmkdir -prule, and remove the stale link by hand onthis machine (the
Makefilenever deletes, by design — see the "never overwrite a destination"constraint in
.agents/skills/dotfiles/SKILL.md).~/cspell.jsoncarries a second oddity worth checking in the same pass:cspell.json:1hardcodes~/.dotfiles/dict/user.txtas a dictionary path, and whether~is expanded there was not verified.Verification
Per file: remove the old link, run the target, and confirm the tool reads the new location —
tmux kill-server; tmux new -d; tmux show-options -g prefixmust returnC-a, which only therepository's configuration sets.