[rednafi]

Sometimes a well-designed, purpose-built tool can replace so many kludgy solutions. This doesn’t solve the problem of reinstating the dotfiles to their original positions in a new machine.

I’ve tried everything from raw git to gnu stow to manual symlinking and everything in between. They all work when the full context of the workflow is fresh in my brain. But after a few weeks I always mess up, even though I’ve documented the process in my dotfiles repo.

I eventually settled on chezmoi, and it just works. I set it up a year ago and haven’t needed anything beyond chezmoi -v diff and chezmoi -v apply.

[colinb]

I’ve been using Chezmoi. It has lots of niceness. Two things are awkward for me. Maybe you have solutions.

I know my way around emacs. vimdiff is a foreign country.

Often my changes are speculative or experimental. So I checkout, edit, apply and only then discover I’ve messed up. Or I can edit in place. Voila vimdiff!

What’s the better way?

[twp]

> I know my way around emacs. vimdiff is a foreign country.

You don't have to use vimdiff. You can use any merge tool you want. See https://www.chezmoi.io/user-guide/tools/merge/.

> Often my changes are speculative or experimental. So I checkout, edit, apply and only then discover I’ve messed up. Or I can edit in place. Voila vimdiff!

> What’s the better way?

There are lots of options. See https://www.chezmoi.io/user-guide/frequently-asked-questions....

Personally, I tend to use `chezmoi edit` and then use git in my source directory to `git add -p . && git commit` the changes I want to keep and `git checkout` to discard the changes I don't want.

[rednafi]

Do you run your changes in the original location?

The canonical workflow is this: you run chezmoi cd and make changes there first. Only then do you run chezmoi apply to propagate the changes to the original location.

The source of truth is always what lies in the chezmoi directory, not the other way around.

So if you’re experimenting with the dotfiles in their original location, running chezmoi apply will override them with the snapshot in the chezmoi directory. The vimdiff doesn’t do much here.

If you want to retain your changes there, you’ll have to manually copy them over to the chezmoi directory. This is a bit awkward, but having a consistent source of truth makes the behavior easier to reason about. I rarely look at the diff.

[DiabloD3]

I would also like to mention Chezmoi.

I switched to it after maintaining a custom written POSIX sh script that kept getting further and further out of hand.

I don't see myself going back to a self-maintained one unless I'm writing it in Rust.

[integrii]

The post does say exactly how to do that. Just init your homedir as a repo, add a remote, and pull. Your dotfiles come right down on top of your new machine's home directory.