LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

tuckr

Symlink-based dotfile manager

TLDR

Symlink all dotfiles into place
$ tuckr add \*
copy
Symlink specific groups
$ tuckr add [neovim] [zsh]
copy
Symlink everything except some groups
$ tuckr add \* -e [neovim]
copy
Set up groups and run their hooks
$ tuckr set [group]
copy
Remove deployed dotfiles
$ tuckr rm [group]
copy
Show symlinking status
$ tuckr status
copy
Copy existing files into a group
$ tuckr push [group] [file]
copy

SYNOPSIS

tuckr command [group...] [options]

DESCRIPTION

tuckr is a dotfile manager that organizes configuration files into logical groups and deploys them as symlinks. Each group represents a set of related dotfiles (such as vim, zsh, or git), allowing selective deployment of configurations across different machines.The add command creates symlinks from the dotfile repository to their expected locations in the home directory. Groups can be linked individually or all at once with the `\*` wildcard, and the status command shows which groups are currently linked. The rm command cleanly unlinks deployed symlinks, while set additionally runs per-group setup hooks.The tool uses a simple directory structure with Configs, Hooks, and Secrets directories, where each subdirectory under Configs represents a group that mirrors the home directory layout within it. Inspired by GNU Stow, it adds hooks and encrypted secrets without requiring symlink-aware tooling.

PARAMETERS

add (alias a)

Deploy dotfiles for the given groups by creating symlinks.
rm
Remove the deployed dotfiles from the system.
set
Set up groups and run their hooks.
unset
Remove groups and run their cleanup hooks.
status (alias s)
Show the symlinking status of dotfiles.
push
Copy existing files into a group.
pop
Remove groups from the dotfiles directory.
encrypt (alias e)
Encrypt files and store them under Secrets.
decrypt (alias d)
Decrypt files.
groupis
Report which group a file belongs to.
init
Initialize the dotfile directory.
-e GROUP
Exclude the given group when used with add.

CAVEATS

Rust implementation. Specific directory structure. Symlink-based.

HISTORY

Tuckr was created as a simple dotfile manager using symlinks with group-based organization.

SEE ALSO

stow(1), chezmoi(1), yadm(1)

Copied to clipboard
Kai