Manage multiple git repos
Project description
A command-line tool to manage multiple git repos
This tool does two things
- display the status of multiple git repos such as branch, modification, commit message side by side
- delegate git commands for the repos from any working directory
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 choice 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 changes*
: unstaged changes_
: untracked files/folders
The bookkeeping sub-commands are
gita add <repo-path(s)>
: add repo(s) togita
gita rm <repo-name>
: remove repo fromgita
(won't remove repo from disk)gita ls
: display the status of all reposgita ls <repo-name>
: display the absolute path of the specified repo
The repo paths are saved in ~/.gita/repo_path
.
The delegated git sub-commands are
gita branch <repo-name(s)>
: show local branches for the specified repo(s)gita clean <repo-name(s)>
: remove untracked files/folders for the specified repo(s)gita difftool <repo-name(s)>
: show differences for the specified repo(s)gita fetch
: fetch remote updates for all reposgita fetch <repo-name(s)>
: fetch remote updates for the specified repo(s)gita log <repo-name(s)>
: show log of the specified repo(s)gita merge <repo-name(s)>
: merge remote updates for the specified repo(s)gita patch <repo-name(s)>
: make a patch for the specified repo(s)gita pull <repo-name(s)>
: pull remote updates for the specified repo(s)gita push <repo-name(s)>
: push local updates of the specified repo(s) to remotegita remote <repo-name(s)>
: show remote settings of the specified repo(s)gita reflog <repo-name(s)>
: show ref logs of the specified repo(s)gita stat <repo-name(s)>
: show repo(s) edit statisticsgita status <repo-name(s)>
: show repo(s) status
The git commands arguments can be found in cmds.yml.
installation
To install the latest version,
pip3 install -U gita
Alternatively, you can download the source code and run pip3 install -e <gita source folder>
,
i.e., the development mode.
In either case, calling gita
in bash may not work,
then you can put the following line in the .bashrc
file.
alias gita="python3 -m gita"
customization
Custom git command aliases can be placed in ~/.gita/cmds.yml
.
For example, gita stat <repo-name(s)>
is registered as
stat:
cmd: diff --stat
help: show edit statistics
and the delegated command is git diff --stat
.
See more examples in the default cmds.yml. Note that custom sub-commands shadow the default ones.
TODO (not tracked by issues)
- auto-completion
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.