bionic (1) git-annex-proxy.1.gz

NAME

       git-annex-proxy - safely bypass direct mode guard

SYNOPSIS

       git annex proxy -- git cmd [options]

DESCRIPTION

       Only  useful in a direct mode repository, this runs the specified git command with a temporary work tree,
       and updates the working tree to reflect any changes staged or committed by the git command.

       For example, to revert the most recent change that was committed to the repository:

        git annex proxy -- git revert HEAD

       To check out a past version of the repository:

        git annex proxy -- git checkout HEAD^^

       To rename a directory:

        git annex proxy -- git mv mydir newname

       To commit the changes to a specific file, first use git annex add to stage the changes in the index,  and
       then proxy a commit:

        git annex add myfile
        git annex proxy -- git commit myfile -m foo

       The  temporary  work  tree that the git command is run in is set up by checking out all files that are in
       the index, and copying (or hard linking) any unstaged files from  the  real  work  tree.  Since  the  git
       command  is  run  using  this  temporary work tree, it won't see eg, local modifications to files. So, it
       probably is not useful to proxy a command like "git add".  However, you can use the proxy  with  any  git
       command you like, as long as you think about how it will interact with the temporary work tree.

SEE ALSO

       git-annex(1)

       git-annex-direct(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                              git-annex-proxy(1)