chezmoi

Automates dotfile deployment and synchronization on macOS using chezmoi templates.

6|2|Updated Jul 8, 2012
One-click install
npx skills add https://github.com/athal7/dotfiles --skill chezmoi-athal7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chezmoi
Source: https://github.com/athal7/dotfiles/tree/main/skills/chezmoi
Command: npx skills add https://github.com/athal7/dotfiles --skill chezmoi-athal7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and safeguards dotfile deployment on macOS by applying templates and managing file state, ensuring consistent environments across machines.

Core Features & Use Cases

  • Deploy and synchronize dotfiles safely with chezmoi, applying templates to user home directories.
  • Manage LaunchAgents, external resources, and per-machine configuration with clear rules and caveats.
  • Use case: provision a new Mac by applying a known dotfiles set and keeping templates in sync across devices.

Quick Start

Initialize and apply your dotfile configuration with chezmoi to provision a safe working environment.

Frequently Asked Questions about chezmoi

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

FAQPage Schema
How do I safely manage dotfiles on macOS using templates?

Safely manage dotfiles on macOS by applying templates to your home directory with chezmoi, ensuring consistent environments across machines without overwriting untracked changes. It enforces safe apply and destroy workflows.

What is the best way to provision a new Mac with consistent configuration?

Provision a new Mac by applying a known dotfiles set with chezmoi to synchronize templates and per-machine configuration. This centralizes deployment and ensures a consistent working environment across devices.

Can I use chezmoi to manage LaunchAgents on macOS?

Yes, you can use chezmoi to manage LaunchAgents on macOS. The deployment process handles LaunchAgents integration, allowing you to safely apply and synchronize these system services alongside your standard dotfiles.

Does chezmoi support per-machine configuration for dotfiles?

Yes, chezmoi supports per-machine configuration for dotfiles by applying templates with specific variables. This allows you to maintain a single source directory while deploying customized configurations to individual macOS machines.

What are the limitations of using templates for dotfile deployment?

When using templates for dotfile deployment, you must respect template and config gotchas to avoid syntax errors. The safe apply and destroy workflows exist to prevent accidental data loss during synchronization.