A customized bash shell suitable for git work.
The git-sh
command starts an interactive bash shell tweaked for heavy git
interaction:
checkout master
= git checkout master
)[alias]
section
of ~/.gitconfig
available at top-level./etc/gitshrc
and ~/.gitshrc
config files;
for creating aliases, changing the prompt, etc.~/.bashrc
) and
readline (~/.inputrc
) configurations.This repository is no longer actively maintained by @rtomayko as of 2017-11-08. Issues and PRs documenting current issues have been intentionally left open for informational purposes.
Install the most recent available version under /usr/local
:
$ git clone git://github.com/rtomayko/git-sh.git
$ cd git-sh
$ make
$ sudo make install
Start a shell with git-sh
:
$ git-sh
master!git-sh> help
Use the PREFIX
environment variable to specify a different install location.
For example, under ~/bin
:
$ make install PREFIX=~
Typical usage is to change into a git working copy and then start the shell:
$ cd mygreatrepo
$ git sh
master!mygreatrepo> help
Core git commands and git command aliases defined in ~/.gitconfig
can be
used as top-level commands:
master!mygreatrepo> checkout -b new
new!mygreatrepo> log -p
new!mygreatrepo> rebase -i HEAD~10
It's really just a normal bash shell, though, so all commands on PATH
and any
aliases defined in ~/.bashrc
are also available:
new!mygreatrepo> ls -l
new!mygreatrepo> vim somefile
IMPORTANT: rm
, mv
, and diff
are aliased to their git counterparts. To use system versions,
run command(1)
(e.g., command rm
) or qualify the command (e.g. /bin/rm
).
The default prompt shows the current branch, a bang (!
), and then the relative
path to the current working directory from the root of the work tree. If the
work tree includes modified files that have not yet been staged, a dirty status
indicator (*
) is also displayed.
The git-sh prompt includes ANSI colors when the git color.ui
option is
enabled. To enable git-sh's prompt colors explicitly, set the color.sh
config
value to auto
:
$ git config --global color.sh auto
Customize prompt colors by setting the color.sh.branch
, color.sh.workdir
,
and color.sh.dirty
git config values:
$ git config --global color.sh.branch 'yellow reverse'
$ git config --global color.sh.workdir 'blue bold'
$ git config --global color.sh.dirty 'red'
$ git config --global color.sh.dirty-stash 'red'
$ git config --global color.sh.repo-state 'red'
See colors in git for information.
Most git-sh
behavior can be configured by editing the user or system gitconfig
files (~/.gitconfig
and /etc/gitconfig
) either by hand or using
git-config(1)
. The [alias]
section is used to create basic command aliases.
The /etc/gitshrc
and ~/.gitshrc
files are sourced (in that order)
immediately before the shell becomes interactive.
The ~/.bashrc
file is sourced before either /etc/gitshrc
or ~/.gitshrc
.
Any bash customizations defined there and not explicitly overridden by git-sh
are also available.
Copyright (C) 2008 Ryan Tomayko
Copyright (C) 2008 Aristotle Pagaltzis
Copyright (C) 2006, 2007 Shawn O. Pearce
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.