skills.rest
RyoMa99
RyoMa99COMMUNITY
Explore all skills by this author →
GitHub

chezmoi-sync

Synchronize chezmoi-managed dotfiles between local filesystem and source repository.

Updated Aug 23, 2026
Search Tags:#git#dotfiles#mise#sync#chezmoi#drift-detection#brew
One-click install
npx skills add https://github.com/RyoMa99/dotfiles --skill chezmoi-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chezmoi-sync
Source: https://github.com/RyoMa99/dotfiles/tree/main/dot_claude/skills/chezmoi-sync
Command: npx skills add https://github.com/RyoMa99/dotfiles --skill chezmoi-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about chezmoi-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect and resolve configuration drift in my chezmoi dotfiles?▼

To detect chezmoi dotfiles drift, run the drift mode to compare live local files against the source repository, which reports discrepancies across skills, rules, Brewfile, and scripts before you apply changes.

Can I pull remote chezmoi dotfile changes and automatically install missing brew and mise tools?▼

Yes, pull mode fetches remote changes via git rebase, shows diffs, and optionally triggers Brewfile package installs and mise tool installations when relevant manifests have changed during the synchronization process.

What is the best way to push local dotfile edits to a chezmoi source repository?▼

The best way to push local edits is using push mode, which detects modifications, manages file additions or forgets, handles password false-positives, and commits changes directly to the chezmoi source repository.

Does chezmoi sync work with Brewfile and local scripts across multiple machines?▼

Yes, the drift detection process supports Brewfile, local scripts, and nvim plugin state across machines, detecting orphaned local files and reporting comprehensive configuration drift between local filesystems and the source repository.

Why does chezmoi diff show unexpected changes after pulling git updates?▼

Unexpected chezmoi diff results after pulling git updates indicate local configuration drift, which you can identify by running drift mode to compare live files against the chezmoi source repository for missed updates or manual edits.

Related Skills

Explore More Software Engineering Skills→
luigiinredluigiinred
1

sync-dotfiles

Synchronize Cursor configuration files with a chezmoi-managed dotfiles repository.

Community
Intermediate
eugenereugener
3

brew-optimize

Analyze Homebrew installations and generate cleanup commands for unused packages.

Community
Intermediate
ivyivy
9

update

Merge Renovate PRs, rebase local branches, and apply chezmoi dotfile updates.

Community
Advanced
gfargogfargo

drift-detection

Detect and fix configuration drift between git-tracked files and VPS runtime state.

Community
Advanced