chezmoi
A command-line tool that manages dotfiles across multiple machines.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
go>=1.25 (build from source)
download get.chezmoi.io install script
curl -fsLS https://get.chezmoi.io -o /tmp/get-chezmoi.shrun script with -b ~/.local/bin (already on PATH)
sh /tmp/get-chezmoi.sh -b "$HOME/.local/bin"
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
curl -fsLS https://get.chezmoi.io -o /tmp/get-chezmoi.shsh /tmp/get-chezmoi.sh -b "$HOME/.local/bin"chezmoi --versionrm -rf ~/czhome ~/czsrc && mkdir -p ~/czhome && cat > ~/czhome/.testrc <<'EOF'
export GREETING="hello from chezmoi"
EOFexport HOME=/home/sbx/czhome && chezmoi init && chezmoi add ~/.testrc && chezmoi managed && rm ~/.testrc && chezmoi apply --force -v && cat ~/.testrcCheck that it works
chezmoi --versionThe output should contain “chezmoi version v2.74.1”.
First thing to try
rm -rf ~/czhome ~/czsrc && mkdir -p ~/czhome && cat > ~/czhome/.testrc <<'EOF'
export GREETING="hello from chezmoi"
EOFexport HOME="$HOME"/czhome && chezmoi init && chezmoi add ~/.testrc && chezmoi managed && rm ~/.testrc && chezmoi apply --force -v && cat ~/.testrcRun chezmoi init to create your dotfiles source directory.
What it does
- Manage dotfiles across multiple machinesTested
How to use it
- Run
chezmoi initto set up chezmoi. - Run
chezmoi add <file>to start managing a dotfile, andchezmoi managedto list managed files. - Run
chezmoi apply --force -vto write your managed dotfiles back to your home directory.
- Run
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 1 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- install chezmoi and apply dotfiles from a GitHub repo on a new machine
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 15 Nov 2026
- Version v2.74.1
Differences the test machine hit
- README: sh -c "$(curl -fsLS get.chezmoi.io)" installs into ./bin
In the test: Pass -b ~/.local/bin (or add ./bin to PATH) so chezmoi is on PATH - README: (nothing)
In the test: chezmoi apply after a managed file was changed/deleted prompts on /dev/tty; in a non-interactive shell use --force - README: (nothing)
In the test: Pointing --source/--destination at custom dirs while adding from /tmp or a dir containing the source failed with 'cannot add chezmoi file to chezmoi (... is protected)'; using a separate HOME with default source dir worked