chezmoi-sync git:20260310.7a56b63A

Immutable. This exact content is served forever at /api/v1/blob/981346fd948f4b65.

---
name: chezmoi-sync
description: Interactive chezmoi drift check and sync. TRIGGERS - chezmoi sync, sync dotfiles, dotfile drift, chezmoi guard, chezmoi check.
allowed-tools: Read, Edit, Bash, AskUserQuestion
---

# Chezmoi Sync (Interactive)

On-demand replacement for the automatic chezmoi stop guard. Run this skill whenever you want to check for chezmoi drift and sync tracked dotfiles.

## Workflow

### Step 1: Check for drift

Run `chezmoi status` and `chezmoi diff --no-pager` to detect drift between the source repo and home directory.

```bash
chezmoi source-path && chezmoi status && echo "---" && chezmoi diff --no-pager | head -80
```

If output is empty (no drift), report "Chezmoi is clean — no drift detected" and stop.

### Step 2: Present drift to user (AskUserQuestion)

If drift exists, use `AskUserQuestion` to show the user what drifted and ask what to do.

**Question 1** (header: "Drift action"):

> "Chezmoi detected N drifted file(s): [list files]. What would you like to do?"

Options:

- **Sync all** — `chezmoi re-add` all drifted files, commit, and push
- **Review each** — Walk through each file individually with per-file choices
- **Ignore** — Skip sync, I'll handle it later

### Step 3a: Sync all (if chosen)

```bash
chezmoi re-add --verbose
chezmoi git -- add -A && chezmoi git -- commit -m "sync: dotfiles" && chezmoi git -- push
chezmoi status  # Verify clean
```

Report the commit hash and confirm clean state.

### Step 3b: Review each (if chosen)

For each drifted file, use `AskUserQuestion`:

**Question** (header: "File action"):

> "[filename] has changed. What should we do?"

Options:

- **Sync** — Add this file to chezmoi source (`chezmoi add <path>`)
- **Diff** — Show the full diff first, then ask again
- **Forget** — Stop tracking this file (`chezmoi forget --force <path>`)
- **Skip** — Leave it drifted for now

After processing all files, if any were synced:

```bash
chezmoi git -- add -A && chezmoi git -- commit -m "sync: dotfiles" && chezmoi git -- push
```

### Step 3c: Ignore (if chosen)

Report: "Skipped chezmoi sync. Run `/dotfiles-tools:chezmoi-sync` when ready."

## Notes

- Always use `chezmoi forget --force` (not bare `forget`) to avoid TTY prompt issues
- The chezmoi source dir is `~/own/dotfiles` (configured in `~/.config/chezmoi/chezmoi.toml`)