chezmoi

Synchronize and version-control configuration files with chezmoi.

2|Updated Sep 9, 2024

Search Tags:#automation #git #developer tools #dotfiles #configuration management #chezmoi #system setup

Ready to run

npx skills add https://github.com/trentshaines/dotfiles --skill chezmoi-trentshaines

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: chezmoi
Source: https://github.com/trentshaines/dotfiles/tree/main/dot_claude/skills/chezmoi
Command: npx skills add https://github.com/trentshaines/dotfiles --skill chezmoi-trentshaines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually managing configuration files across multiple machines is error-prone and time-consuming. This Skill automates the synchronization and version control of your dotfiles, ensuring your development environment is always consistent and backed up.

Core Features & Use Cases

Automated Config Sync: Effortlessly sync changes from your home directory to your dotfiles repository.
Version Control Integration: Leverage Git for full history and easy rollbacks of your configurations.
Use Case: After tweaking your ~/.zshrc or adding a new tmuxinator template, simply ask Claude to sync your changes, and it will handle the chezmoi re-add, git commit, and git push workflow for you.

Quick Start

I've just updated my ~/.zshrc. Please sync this change to my dotfiles repository using chezmoi.

Frequently Asked Questions about chezmoi

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

FAQPage Schema

How do I sync dotfile changes back to my repository?▼

Dotfile synchronization with chezmoi captures modifications in your home directory and pushes them to version control. Use chezmoi re-add to stage changed files, then commit and push to your dotfiles repository, preserving your configuration history across machines.

What's the difference between chezmoi add and re-add?▼

The add command imports a new file into chezmoi management, while re-add updates an already-managed file with its current state. Use re-add after editing tracked dotfiles to capture changes before syncing them to your repository.

Can I use chezmoi to manage configuration files across multiple machines?▼

Yes, chezmoi manages dotfiles across machines by storing them in a Git repository. After syncing changes from one machine, other systems can pull updates to keep their configurations consistent and version-controlled.

How do I track new configuration files with chezmoi?▼

Use chezmoi add to import new files from your home directory into management. The Skill identifies which files to add, manages the workflow to include them in your dotfiles repository, and handles the commit-and-push cycle.

What happens to my configuration history when I sync with chezmoi?▼

Chezmoi preserves full Git history of all dotfile changes. Every sync creates a commit record, enabling rollback to previous configurations if needed and providing an audit trail of all modifications across your managed directories.

Do I need to manually commit after running chezmoi re-add?▼

The Skill automates the full workflow: it stages changes with chezmoi re-add, commits them with a descriptive message, and pushes to your repository. You review and approve before committing, eliminating manual Git commands.