vcsh

vcsh [init|clone|list|enter|run|pull|push] [reponame] [args]

vcsh manages configuration files (dotfiles) using multiple Git repositories that all share the same working directory ($HOME). Each repository tracks a separate set of files, allowing modular organization of shell configs, editor settings, and other dotfiles.The tool uses bare Git repositories to avoid conflicts between repos that coexist in the same directory. The enter command opens a subshell scoped to a specific repository, while running git commands directly against a named repo is also supported.

init reponame

Initialize an empty repo.

Clone from URL.

List all repos.

List tracked files.

List untracked files. -a shows all, -r is recursive.

Spawn subshell with $GIT_DIR set.

Run command with $GITDIR and $GITWORK_TREE set.

Pull from all repos.

Push all repos.

Rename a repository.

Show status of all or one repo.

Write .gitignore.d/reponame via git ls-files.

Delete a repository.

VCSH_REPO_D

Directory where bare repositories are stored (default: $XDGCONFIGHOME/vcsh/repo.d).

Requires basic Git knowledge. Bare repositories can be confusing -- use `vcsh enter` to inspect repo state. Files tracked by multiple repos will cause conflicts.

vcsh (version control system for $HOME) was created by Richard Hartmann for managing multiple Git repositories overlaid on $HOME.

git(1), mr(1), stow(1), yadm(1), chezmoi(1)