~ sweet ~ , a dotfile manager

hsh is a git wrapper, mainly useful to manage dotfiles. Its most salient features are:

• hsh is a simple shell script, most of the heavy lifting is carried out by git;
• hsh can create modular configurations by splitting dotfiles into separate repos (e.g. work/personal, headless/gui, gihub/private/offline...);
• hsh simplifies setting up a new machine by creating a bundle of your current config, that can then be installed elsewhere;
• hsh is not a link farm, files are checked out directly from git directories and conflicts on common files are handled by sparse-checkout settings.

Install

cd
curl -sSL https://raw.githubusercontent.com/crezvoy/hsh/master/install-script.sh | sh

The install script creates a .hsh directory in the current working directory, in this directories, all the .git repositories are stored, including hsh itself. The install script also checks out the hsh script in the bin subdirectory.

Available options:

• -C <path> act as if the install script was called from <path>
• -b, --bin <path> check out the hsh script in <path>

Commands

All hsh commands adhere to the following syntax; either the command is applied to a sigle repository as such:

hsh [-C <dir>] <git command> <repository name> <git arguments>

or, you apply the same command to all the repositories:

hsh [-C <dir>] <git command> all <git arguments>

in that form, the hsh command fails if all the git commands fail. By default hsh will act on the nearest .hsh directory up the directory tree but all commands accept a -C argument to change the current directory before any action. most commands are forwarded directlyu to git, hsh do however add new commands or override git ones.

Init

hsh [-C <dir>] init <name>

The init command creates a new repository <name> in hsh.

Clone

hsh [-C <dir>] clone <url|url-ish>

The clone command clone an existing repository by putting the .git directory in the .hsh directory and checkng out the default branch. The command does not accept any parameters other than -C.

Bundle

hsh [-C <dir>] bundle [-f | --force] [[-n | --name] <dir>]

This commands creates a self-extractible archive of your current repositories to be replicated into another location. When run, the bundle will recreate a .hsh directory as well as copy the worktree of all your repositories in the current directory. The bundle extraction does not require git so that it is an appropriate method for a new setup. The bundle itself as the following options:

hsh_bundle [-C <dir>] [[-b | --bin] <dir>]

As for other command, -C changes the current directory. one of the repo that are extracted by the bundle is hsh itself, the --bin option allow you to customize the path to where ths hsh script is extracted and defaults to ./bin.

Dependencies

hsh [-C <dir>] dependency <repo> [[add|rm] <repository url>]

A repository can depend on others. Dependencies are installed along with the repository. When removing a repository all dependent repositories are removed as well. the hsh dependency allows listing, adding removing dependencies to a repository.

Edit

hsh edit <repo> <file>

The edit command allows to modify files that are not checked out to the worktree as they would clutter the worktree and conflict between the different repositories:

• README.md
• LICENSE
• .gitignore
• .gitattributes
• h.sh

Modified files are staged directly after edition.

Synopsis

# create a repository 
hsh init vim
# most git command are simply passed onto the corresponding git repo
hsh remote vim add [email protected]/myself/hsh-vim
# add file to the repo
hsh add vim .vimrc
# you can also apply a command to all repository at once
hsh commit all -m "syncing dotfiles"
# by default hsh repositories configured to rebase on pull
hsh pull all
hsh push all

Roadmap

• dependencies
• hooks (install update etc.)
• portability tests
• bash completion
• CI
• github/gitlab url shortening

License

hsh is licensed under the terms of the MIT license. For more information refer to the LICENSE file.