gg 1.0 released!
I’m proud to announce the first stable release of gg, my alternative Git command-line interface! This has been a release over two years in the making: I’ve battle-tested gg across many different workflows and projects. It’s saved me tons of time every day, and I hope it can save time for others too. Download the latest release and try it out for yourself!
gg is a tool I built to ease my day-to-day version control experience. In particular, I wanted to restore my productivity to the level I had when using Mercurial: easy-to-remember commands with reasonable defaults.
For example, a frequent task is updating your local copy with the latest upstream changes. In Mercurial, this was as straightforward as:
hg pull -u
In Git, there’s much more typing.
git stash git pull --ff-only git stash pop # resolve conflicts if you need to git stash drop # if there were conflicts
In gg, this same operation is:
gg pull -u
Along with a more focused set of commands, gg provides:
git commit -atakes 13 characters to type.
gg citakes 5 to do the same thing (don’t worry, you can still type
- Built for GitHub and Gerrit. gg has built-in support for creating pull requests and creating Gerrit changesets straight from the command-line. No more context switching.
- Safer rebases.
gg rebaseautomatically detects common mistakes while rebasing and infers the correct change.
- Local branches match remote branches. Using
gg pullautomatically creates branches that match your remotes to avoid confusion.
- Optional staging. gg avoids using the staging area to save on typing and mistakes. However, gg takes great care to avoid perturbing the staging area, so for more advanced commits, you can keep using the same Git commands you’re used to.
- Works with existing Git tools. You can use or not use gg as much as you
want in your workflow. gg is just a wrapper for the Git CLI, so it works with
any hooks or custom patches to Git that your project may use. You can see the
exact Git commands gg runs by passing in
Now you may ask, why does this need a whole new program to solve? I started gg
as a set of Git shell aliases, but soon I realized that what I wanted had a much
larger scope. To provide high-level assurances for trickier operations like
gg update or
gg rebase, gg needs to parse Git output to understand user
intent and check for edge conditions. This simply would have been too difficult
or hard-to-package as a collection of shell scripts.