yadm-alt

Create symbolic links between alternate files manually

$ yadm alt

yadm-alt [options] [command]

--help
    Display help message

--version
    Show version information

init
    Initialize a yadm repository in the current directory, and setup remote.

clone
    Clone a yadm repository from a remote location.

add ...
    Add files to the yadm repository.

remove ...
    Remove files from the yadm repository.

status
    Show the status of the yadm repository.

commit
    Commit the changes in the yadm repository.

push
    Push the changes to the remote repository.

pull
    Pull the changes from the remote repository.

link
    Create symlinks to the tracked dotfiles in the home directory.

checkout
    Switch or create/restore branches in your yadm repo.

yadm-alt is a command-line tool, built on top of yadm, designed for managing your dotfiles (configuration files) in a Git repository.

It offers a means to use an alternative storage location, which means you can have dotfiles located outside of your home directory, allowing for better organization and separation of concerns. This is particularly useful when managing dotfiles for different systems or environments. It simplifies the process of tracking, versioning, and deploying dotfiles across multiple machines or user accounts, making configuration management easier. yadm-alt handles file synchronization, ensuring that your configurations are consistently applied wherever you need them. yadm-alt requires git to be installed. Its main benefit is to prevent possible conflicts by not placing files that it is tracking in the home directory by default.

The user can then decide if they're happy with just symlinking, or rather making physical copies of the dotfiles

Requires Git to be installed and configured.

yadm-alt uses the same configuration format as yadm.

It can be customized through a .yadmconfig file in the root of the yadm repository, or through git configuration variables.

After initialization using "yadm init", you should move your dotfiles to the yadm-alt storage directory to keep them separate from your home directory.

yadm-alt is a customized version of yadm.

yadm, the original, was created to simplify dotfile management, by wrapping git commands. yadm-alt improves on this by addressing the challenge that files can create conflicts if placed in the home directory.

git(1), yadm(1)