dot

dot is a small dotfiles manager which maps declared files (in config) to destination with symlinks. It adds or removes the symlinks based on configuration.

Link to GitHub repository for dot

usage

• In ~/.dotfiles/ create a new file called .mappings

• It should be in TOML format with everything under [general] table.

• The entries should be "source" = "destination" where source should have path relative to ~/.dotfiles/ whereas destination should not.

  example .mappings

  [general]
  # ghostty/config is ~/.dotfiles/ghostty/config
  "ghostty/config" = "/home/username/.config/ghostty/config"
  
  # starship/config is ~/.dotfiles/starship/config
  "starship/config" = "~/.config/starship/config"
  

• Then, start using the CLI with dot link or dot l to map everything.

• If you want to remove all links then use dot remove or dot r.

• If you want to check status of entries on which one is not linked and which is use dot status or dot s.

USAGE:
   dotfiles [global options] command [command options]

COMMANDS:
   link, l    Link all dotfiles declared on .mappings
   remove, r  Remove all managed symlinks
   status, s  Show symlink status
   help, h    Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

IF YOU ARE USING GIT OR ANY OTHER VERSION CONTROL REMEMBER TO IGNORE .state FILE IN YOUR ~/.dotfiles/ DIRECTORY.