dotcat

Crates.iodotcat
lib.rsdotcat
version1.1.1
created_at2025-08-16 13:22:50.185692+00
updated_at2025-09-03 17:15:00.037566+00
descriptionA simple tool to manage dotfiles on linux
homepage
repositoryhttps://github.com/Whiskers-Apps/dotcat
max_upload_size
id1798436
size39,585
lighttigerXIV (lighttigerXIV)

documentation

README

About

This simple program is used to manage dotfiles. I find most tools like stow are annoying to deal with so I created a cli app to manage them.

Install

To install the app you can use cargo:

cargo install dotcat

Alternatively you can download from the releases page

Usage

[!IMPORTANT] It's required to run the setup command to set the location for your dotifles.

dotcat setup ~/dotfiles/

You can change ~/dotfiles to whatever folder that fits your needs.


To add a dotfile:

# For a file
dotcat link ~/.config/dotcat.toml

# For a directory
dotcat link ~/.config/nvim

# For a file and skip the name prompt
dotcat link ~/.config/nvim neovim

You can also give a relative path and it should work the same. Also if no name is provided it will prompt for one.


To remove a dotfile:

dotcat unlink neovim

This only requires the dot name


To link the whole dot database (Useful when setting up your pc or after Arch broke ;-;):

dotcat link-db

To unlink the whole dot database:

dotcat unlink-db

To migrate the dots from the current dots directory to another:

dotcat migrate ~/.dots

To list the active dots:

dotcat list

You can also check the help if you are feeling a bit lost:

dotcat help
Commit count: 10

cargo fmt