chezmoilisted

# Chezmoi Source Standard The source tree (`~/.local/share/chezmoi`) is the only thing to edit; `chezmoi apply` renders it into `$HOME`, so a change made under `~/.config` or `~/.gemini` is overwritten on the next apply. File names encode target path, mode, encryption, and rendering; [mise](../../../skills/mise/SKILL.md) wraps the commands as tasks. ## Naming Read [source names](references/source-names.md) when adding or renaming a managed target; attributes depend on the target type. ## Workflow 1. **Edit the source**, never the deployed copy; `chezmoi cd` opens a shell in the source root. 1. **Manage an existing file**: `chezmoi add <target>` infers the attributes; `--template` templatizes; set a secret to `0600` before `--encrypt` imports it as `encrypted_private_dot_<name>.age`: ```bash chmod 600 ~/.config/<tool>/secret chezmoi add --encrypt ~/.config/<tool>/secret # import and encrypt into the source chezmoi edit ~/.config/<tool>/secret # edit the plaintext, re-encrypt on save ``` 1. **Preview**: `mise run diff` (`chezmoi diff`; add `--force` in automation to skip prompts). 1. **Validate rendering**: `mise run check:chezmoi` uses temporary configuration and destination with a dry run excluding encrypted files. It checks the current platform; exercise changed Linux/macOS branches separately and report unexercised branches or encrypted targets. 1. **Check repeatability**: for Bash/profile modifier changes, add existing-target and second-p