chezmoi-sync

name	chezmoi-sync
description	Sync changes made to live dotfiles back into the chezmoi source repo. Use when the user has edited a file in their home directory (or other chezmoi target) and wants the chezmoi source (plain files, `.tmpl` templates, or included partials under `.chezmoitemplates/`) updated so `chezmoi diff` is clean again. Triggers on: "sync to chezmoi", "pull changes into chezmoi", "update the template to match", "make chezmoi diff empty".
compatibility	Requires `chezmoi` on PATH. Must be run with the user's chezmoi source directory accessible (typically ~/.local/share/chezmoi).

chezmoi-sync

Reverse-apply edits from the destination (live home dir) back into the chezmoi source repo. The goal: after this skill runs, chezmoi diff for the target file(s) reports nothing.

Inputs

• Filename (optional): a target path like ~/.finicky.js or ~/.config/fish/config.fish.
  • If provided, only that file is synced.
  • If not provided, list all differing files and ask the user which to sync.

Workflow

1. Discover differences

• If the user gave a filename, skip to step 2 with just that path.
• Otherwise run chezmoi diff with no arguments and parse which target files have differences. Each diff block starts with an underlined header that is the target-relative path (for example .finicky.js or .config/fish/config.fish).
• Present the list of differing files to the user and ask which ones to sync. Do not assume "all" - wait for an explicit choice.

2. For each file the user selected