Sync Dotfiles to chezmoi

Reference: See chezmoi-docs.md in this skill for command reference.

Choose the right flow from user intent:

Update vs sync

Trigger Conditions

Run this skill automatically (without being asked) whenever you have just:

• Created, edited, or deleted a file in ~/.cursor/skills/
• Created, edited, or deleted a file in ~/.cursor/agents/
• Created, edited, or deleted a file in ~/.cursor/rules/

Also run when the user explicitly asks to update dotfiles, sync dotfiles, push dotfiles, or update chezmoi.

Push workflow (sync / push dotfiles)

When the user wants to save local Cursor changes to the dotfiles repo, use chezmoi only (no raw git or cd to source). All git runs via chezmoi git in the source directory.

1. Capture local changes

   bashCopy

   chezmoi re-add ~/.cursor/skills ~/.cursor/agents ~/.cursor/rules
   

   If only skills changed, scope to that path. For new untracked files use chezmoi add PATH.

2. Stage and commit

   bashCopy

   chezmoi git add -A
   chezmoi git -- diff --cached --quiet || chezmoi git -- commit -m "chore: sync cursor config"
   

   Use a more specific message when clear (e.g. chore: add new skill foo-bar). Put -- before git flags so chezmoi doesn’t interpret them.

3. Pull remote and rebase

   bashCopy

   chezmoi git -- pull --rebase
   

   Local changes are already committed, so rebase keeps both sides.

4. Apply merged state

   bashCopy

   chezmoi apply
   

5. Push

   bashCopy

   chezmoi git push
   

Notes

• Never commit files outside dot_cursor/ without explicit user request.
• If chezmoi re-add fails on a new file (not yet tracked), use chezmoi add instead.