vcsh.1.ronn

vcsh(1) - Version Control System for $HOME - multiple Git repositories in $HOME
===============================================================================

## SYNOPSIS

`vcsh` [<options>] <command>

`vcsh` clone <url> [<repo>]

`vcsh` delete <repo>

`vcsh` enter <repo>

`vcsh` help

`vcsh` init <repo>

`vcsh` list

`vcsh` list-tracked

`vcsh` list-tracked-by <repo>

`vcsh` pull

`vcsh` push

`vcsh` rename <repo> <newname>

`vcsh` run <repo> <shell command>

`vcsh` upgrade <repo>

`vcsh` version

`vcsh` which <substring>

`vcsh` write-gitignore <repo>

`vcsh` <repo> <git command>

`vcsh` <repo>


## DESCRIPTION

`vcsh` allows you to have several `git`(1) repositories, all maintaining their
working trees in $HOME without clobbering each other. That, in turn, means you
can have one repository per config set (zsh, vim, ssh, etc), picking and
choosing which configs you want to use on which machine.

`vcsh` is using a technique called fake bare Git repositories, keeping <$GIT_DIR>
in a different directory from <$GIT_WORK_TREE> which is pointed to <$HOME>.

The use of symlinks is not needed in this setup, making for a cleaner setup.

`vcsh` was designed with `mr`(1) in mind so you might want to install it alongside
vcsh. That being said, you can easily use `vcsh` without `mr` if you prefer.

A sample configuration for `vcsh` and `mr` can be found at
*https://github.com/RichiH/vcsh_mr_template* and used with `vcsh clone
https://github.com/RichiH/vcsh_mr_template mr`.

Please note that you can always use a path instead of a name for <repo>.
This is needed to support mr and other scripts properly and of no concern to
an interactive user.

## OPTIONS

* -c: