gita 0.4.8

Manage multiple git repos

A command-line tool to manage multiple git repos

This tool does two things

• display the status (branch, modification) of multiple git repos side by side
• delegate git commands for registered repos

See the following screenshot for example:

Here the colors denote the 5 situations between local and remote branches:

• white: the local branch has no remote branch.
• green: the local branch is the same as the remote branch.
• red: the local branch has diverged from the remote branch.
• purple: the local branch is ahead of the remote branch (good for push).
• yellow: the local branch is behind the remote branch (good for merge).

The color choices of purple for ahead and yellow for behind is motivated by blueshift and redshift, using green as baseline.

The additional status symbols have the following meaning:

• +: staged change exists
• *: unstaged change exists
• _: untracked files/directories exist

The supported sub-commands for git delegation are

• gita add <repo-path>: add repo to gita
• gita rm <repo-name>: remove repo from gita (won't remove repo from disk)
• gita ls: display the status of all repos
• gita ls <repo-name>: display the absolute path of the specified repo
• gita fetch: fetch all remote updates
• gita fetch <repo-name(s)>: fetch remote updates for the specified repo(s)
• gita pull <repo-name(s)>: pull remote updates for the specified repo(s)
• gita merge <repo-name(s)>: merge remote updates for the specified repo(s)
• gita push <repo-name(s)>: push local updates of the specified repo(s) to remote

The repo paths are saved in ~/.gita_path

installation

To install, simply use

pip3 install gita

Alternatively, you can download the source code and run pip3 install -e <gita source folder>. This is known as the development mode. In this case, calling gita in bash may not work, and you can put the following line in the .bashrc file

alias gita="python3 -m gita"

TODO

• auto-completion