legit 0,2,9,0,1,1,0,-1 travis-ci python

Git for Humans, Inspired by GitHub for Mac™.

2 years after BSD-3-Clause

.. --restructuredtext--

Legit: Git for Humans

Inspired by GitHub for Mac.

The Concept

GitHub for Mac <http://mac.github.com>_ is not just a Git client.

This comment <https://news.ycombinator.com/item?id=2684483>_ on Hacker News says it best:

They haven't re-created the git CLI tool in a GUI, they've created something different. They've created a tool that makes Git more accessible. Little things like auto-stashing when you switch branches will confuse git veterans, but it will make Git much easier to grok for newcomers because of the assumptions it makes about your Git workflow.

Why not bring this innovation back to the command line?

The Interface

branches Get a nice pretty list of available branches.

sync [<branch>] Synchronizes the given branch. Defaults to current branch. Stash, Fetch, Auto-Merge/Rebase, Push, and Unstash. You can only sync published branches. (alias: sy)

resync <upstream-branch> Stashes unstaged changes, Fetches, Auto-Merge/Rebase upstream data from specified upstream branch, Performs smart pull+merge for current branch, Pushes local commits up, and Unstashes changes. Default upstream branch is 'master'. (alias: rs)

switch <branch> Switches to specified branch. Defaults to current branch. Automatically stashes and unstashes any changes. (alias: sw)

publish [<branch>] Publishes specified branch to the remote. (alias: pub)

unpublish <branch> Removes specified branch from the remote. (alias: unp)

undo Un-does the last commit in git history.

install Installs legit git aliases.

help Displays help for legit command. (alias: h)

The Installation

.. image:: https://img.shields.io/pypi/v/legit.svg :target: https://pypi.python.org/pypi/legit/

From PyPI <https://pypi.python.org/pypi/legit/>_ with the Python package manager::

pip install legit

Or download a standalone Windows executable from GitHub Releases <https://github.com/kennethreitz/legit/releases>_.

You'll then have the wonderful legit command available. Run it within a repository.

To install the git aliases, run the following command::

legit install


  • All remote operations are carried out by the remote identified in $ git config legit.remote remotename
  • If a stash pop merge fails, Legit stops. I'd like to add checking for a failed merge, and undo the command with friendly error reporting.

Related Repositories



A Legit-Use Everything Bank and Save Manager for Gen 3 ...



A gem utilizing a collection of git hooks to make dealing with accurev a bit mor ...



Python tool for downloading content from CDN, packages it with your tickets. Can ...



a lightweight javascript framework for modifying the DOM / CSS ...



A Sass based generator for a fluid grid with fluid gutters ...

Top Contributors

kennethreitz hickford wkentaro weakish AkeemMcLennon blueyed suan laurentb miguelbaldi grantcox bbonf mxey zerok calebegg displacedaussie davidthewatson erikdejonge fcurella balihoo-aharl jensck acrobat joakim jjb lovato OctoKatie tallowen raylillywhite Autoplectic TCattd doggy8088


-   v0.2.1 zip tar
-   v0.2.0 zip tar
-   v0.1.1 zip tar
-   v0.1.0 zip tar
-   v0.0.9 zip tar