Home

What is Tuckr?

Tuckr is a dotfile manager as well as a symlink farm. It aims to reduce the amount of work necessary to get up and running on a new machine. It takes inspiration from other existing dotfile managers such as chezmoi and yadm and borrows all of its ideas from GNU Stow's simplicity.

Since simplicity is at the core of GNU Stow and one of the goals of this project's goal, the tool tries as much as possible to avoid any sort of configuration file and instead is opinionated on how dotfile repos should be structured.

How does Tuckr work?

Dotfile validity checks

All dotfiles are stored inside a Configs directory where each directory in it is related to a certain group or program. Tuckr uses this to group the dotfiles and examine the state of these groups in the host machine. It achieves this by going through the file system and checking where symlinks point to, if it points to the related dotfile in the repo it's deemed as symlinked and valid, otherwise it's deemed as unsymlinked and put into a list of unsymlinked dotfiles.

All these checks are done right after the program's execution starts. Once the entire repo's state is mapped to either of the following states: symlinked, not_symlinked or not_owned. The actual command execution starts.

Some commands work only on dotfiles with certain statuses.