chezmoi-sync

What problem does it solve?

Synchronizes chezmoi-managed dotfiles and related configuration across local machines and the source repository to avoid configuration drift, missed updates, and manual error-prone merges.

Core Features & Use Cases

• Pull mode: fetch and apply remote changes with rebase, show diffs, and optionally install tools when relevant manifests changed.
• Push mode: detect local edits, add/forget files to chezmoi, handle password false-positives, commit and push the chezmoi source repository.
• Drift mode: produce a comprehensive drift report comparing live files to chezmoi source, including skills, rules, local scripts, Brewfile and nvim plugin state.
• Integrations: checks and optional actions for mise tool installs, Brewfile package installs, and orphaned local file detection.

Quick Start

Run the chezmoi-sync skill with a mode argument such as pull, push, or drift to update or report on your chezmoi-managed dotfiles.