homeshick

homeshick command [arguments]

homeshick is a Git-based dotfile synchronizer written in Bash. It uses "castles" (Git repositories) to manage dotfiles, creating symlinks from the repository to your home directory.
Each castle is a Git repository stored in ~/.homesick/repos/. Files tracked in a castle are moved into the repository and replaced with symlinks pointing back to the repository copy. This allows version control and easy synchronization across machines.

generate NAME

Create a new castle (dotfiles repository)

Add a file to a castle and replace with symlink

Change directory to a castle

Clone a castle from a Git repository

Create symlinks from castle to home directory

Pull updates for a castle

Check if any castles have updates

Requires Bash and Git. Symlinks may not work correctly on some filesystems or in containers. Conflicts can arise when multiple castles contain the same file.

homeshick was created by Anders Ingemann as a pure Bash alternative to homesick (a Ruby gem). The name combines "home" (dotfiles) with "shell" (Bash implementation).

chezmoi(1), stow(8), git(1)