personal-os-setup: Skill for Claude Code

chezmoi script scoping in personal-os-setup

The core gotcha: a targeted chezmoi apply does not run sibling scripts

The "Sync dotfiles" tab's apply selected/diff selected buttons never run a bare chezmoi apply — chezmoi_apply() in tasks/system/chezmoi.py always passes the selected paths as explicit targets: chezmoi apply --force --parent-dirs <target1> <target2> .... A run_/run_once_/run_onchange_ script only executes if its own managed path is in that target list — being in the same directory as a targeted file is not enough:

• chezmoi apply <only .zshrc> → noctalia/hypr untouched, scripts don't run.
• chezmoi apply <only noctalia/config.toml> (a sibling of the script in the same dir) → the script still does not run.
• chezmoi apply <the script's own managed path> → script runs.

Reproduce it against a scratch source dir before relying on the behaviour:

mkdir -p /tmp/t/{home,src/dot_config/x} && cd /tmp/t
echo x > src/dot_config/x/file.txt
printf '#!/bin/bash\necho RAN\n' > src/dot_config/x/run_after_thing.sh
HOME=$PWD/home chezmoi --source $PWD/src apply -v --force --parent-dirs $PWD/home/.config/x/file.txt
# "RAN" does not print -- the script's own path wasn't a target.

Why this matters for the frontend's dotfiles tree

chezmoi_managed_paths() (tasks/system/chezmoi.py) calls chezmoi managed --include=files,scripts,symlinks, so scripts show up as their own selectable leaf entries in the tree (app.py's Tree[DotfileTreeNode]), separate from the config files next to them. Tree-node selection (on_tree_node_selected → data.all_file_paths()) selects every leaf under whichever node you click:

• Select only noctalia/config.toml and click apply selected → the config applies, but run_after_ensure-noctalia-running.sh.tmpl (a sibling leaf) does not fire.
• Select the whole noctalia folder → the script leaf is included, so it fires.
• Same rule for run_after_check-hyprland-plugins.sh.tmpl under hypr.