chezmoi(1)
chezmoi is a dotfile manager that securely manages your configuration files across multiple machines.
Synopsis
chezmoi [OPTIONS] COMMAND [ARGS]...Description
chezmoi helps you manage dotfiles (configuration files in your home directory) with version control, encryption, and cross-machine synchronization. It stores your dotfiles in a source directory, applies them to your home directory, and can track local modifications.
chezmoi supports templating for machine-specific configurations, encryption of sensitive files, and seamless updates across multiple computers. It integrates with git for version control and can fetch dotfiles from remote repositories.
Common options
| Flag | What it does |
|---|---|
-c, --config STRING | configuration file path (default: ~/.config/chezmoi/chezmoi.toml) |
-S, --source STRING | source directory path (default: ~/.local/share/chezmoi) |
-D, --destination STRING | destination directory path (default: home directory) |
-v, --verbose | enable verbose output to see applied changes |
--dry-run | show what would be done without making changes |
-i, --interactive | prompt for confirmation before applying changes |
--color STRING | colorize output (auto, on, or off) |
-h, --help | show help message for a command |
Examples
initialize chezmoi and clone dotfiles from a remote repository
chezmoi init https://github.com/user/dotfiles.gitadd a configuration file to chezmoi's source directory
chezmoi add ~/.config/nvim/init.vimpreview what changes would be applied to your home directory
chezmoi apply --dry-runapply all managed dotfiles to your home directory
chezmoi applyshow which dotfiles differ between source and home directory
chezmoi statusedit a managed dotfile in your source directory
chezmoi edit ~/.bashrcpull latest changes from remote repository and apply them
chezmoi updatelist all files managed by chezmoi
chezmoi managed