|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Zsh Git Prompt||1,505||2 years ago||1||February 27, 2018||59||mit||Haskell|
|Informative git prompt for zsh|
|Dotfiles||1,158||a month ago||2||Shell|
|Colourful & robust configuration files and utilities for Mac, Linux and BSD|
|Hyperzsh||442||1||2||4 years ago||3||March 21, 2017||mit|
|A hyperminimal zsh prompt|
|Dotfiles||268||2 months ago||2||Shell|
|My lovely dots ~/.💖|
|Git Fixup||202||7 months ago||1||February 27, 2018||4||isc||Shell|
|Fighting the copy-paste element of your rebase workflow.|
|Git Now||144||a year ago||1||March 03, 2021||1||gpl-2.0||Shell|
|A temporary commit tool for git|
|Odin||73||5 years ago||Makefile|
|A git flavored zsh prompt|
|Zsh Vcs Prompt||73||8 years ago||4||Shell|
|This scripts is customizable vcs (git/svn/hg) info for zsh prompt.|
|Git Templates||29||4 years ago||gpl-2.0||Shell|
|Templates / Hooks for Your Git Repositories|
|Git||26||10 days ago||1||mit||Shell|
|Provides nice git aliases and functions.|
zsh prompt that displays information about the current git repository. In particular the branch name, difference with remote branch, number of files staged, changed, etc.
(an original idea from this blog post).
The prompt may look like the following:
(master↑3|✚1): on branch
master, ahead of remote by 3 commits, 1 file changed but not staged
(status|●2): on branch
status, 2 files staged
(master|✚7…): on branch
master, 7 files changed, some files untracked
(master|✖2✚3): on branch
master, 2 conflicts, 3 files changed
(experimental↓2↑3|✔): on branch
experimental; your branch has diverged by 3 commits, remote by 2 commits; the repository is otherwise clean
(:70c2952|✔): not on any branch; parent commit has hash
70c2952; the repository is otherwise clean
Here is how it could look like when you are ahead by 4 commits, behind by 5 commits, and have 1 staged files, 1 changed but unstaged file, and some untracked files, on branch
By default, the general appearance of the prompt is:
(<branch><branch tracking>|<local status>)
The symbols are as follows:
|…||there are some untracked files|
|↑n||ahead of remote by
|↓n||behind remote by
|↓m↑n||branches diverged, other by
When the branch name starts with a colon
:, it means it’s actually a hash, not a branch (although it should be pretty clear, unless you name your branches like hashes :-)
Clone this repository somewhere on your hard drive.
Source the file
zshrc.sh from your
~/.zshrc config file, and
configure your prompt. So, somewhere in
~/.zshrc, you should have:
source path/to/zshrc.sh # an example prompt PROMPT='%B%m%~%b$(git_super_status) %# '
Go in a git repository and test it!
There is now a Haskell implementation as well, which can be four to six times faster than the Python one. The reason is not that Haskell is faster in itself (although it is), but that this implementation calls
git only once. To install, do the following:
cdto this folder
stack setupto install the Haskell compiler, if it is not already there
stack build && stack install(don't worry, the executable is only “installed” in this folder, not on your system)
GIT_PROMPT_EXECUTABLE="haskell"somewhere in your
sourcestatement) to adapt it to your needs (to change the order in which the information is displayed).
ZSH_THEME_GIT_PROMPT_CACHEin order to enable caching.
ZSH_THEME_GIT_PROMPT_) to change the appearance of the prompt. Take a look in the file
zshrc.shto see how the function
git_super_statusis defined, and what variables are available.