$ g

Passthrough to your current directory's VCS.

A command-line shortcut that runs your current directory's VCS command, whether it's git, subversion (svn), or mercurial (hg). Requires Python 3.10 or newer.

$ pip install --user g

Or install with uv:

$ uv tool install g

Working inside a uv-managed project:

$ uv add g

For one-off use without installing globally:

$ uvx g

$ g

You can test the unpublished version of g before its release.

• pip:

  $ pip install --user --upgrade --pre g

• uv:

  $ uv tool install --prerelease=allow g

  $ uv add g --prerelease allow

  $ uvx --from 'g' --prerelease allow g

• pipx:

  $ pipx install --suffix=@next g --pip-args '\--pre' --force

  Then use g@next --help.

$ g status

Inside a git checkout, that runs git status; inside svn, svn status; inside mercurial, hg status. g intercepts only -V/--version — everything else, including -h/--help, forwards straight to the detected VCS. The VCS's own stdout and stderr print through unchanged, but g's exit status does not mirror the wrapped command's: a completed run always exits 0. Outside a VCS directory, g prints No VCS found in current directory. to stderr and stops.

Full detection order and command reference: https://g.git-pull.com/cli/index.html.

2021-12-05: Thanks to John Shanahan (@_shanahanjrs) for giving g use g

Your donations fund development of new features, testing and support. Your money will go directly to maintenance and development of the project. If you are an individual, feel free to give whatever feels right for the value you get out of the project.

See donation options at https://tony.sh/support.html.

• Python support: >= 3.10
• VCS supported: git(1), svn(1), hg(1)
• Source: https://github.com/vcs-python/g
• Docs: https://g.git-pull.com
• Changelog: https://g.git-pull.com/history.html
• API: https://g.git-pull.com/api.html
• Issues: https://github.com/vcs-python/g/issues
• Test Coverage: https://codecov.io/gh/vcs-python/g
• pypi: https://pypi.python.org/pypi/g
• Open Hub: https://www.openhub.net/p/g
• License: MIT.