gitin
gitin
is a commit/branch/status explorer for git
gitin is a minimalist tool that lets you explore a git repository from the command line. You can search from commits, inspect individual files and changes in the commits. It is an alternative and interactive way to explore the commit history. Also, you can explore your current state by investigating diffs, stage your changes and commit them.
Features
- Fuzzy search (type
/
to start a search after runninggitin <command>
) - Interactive stage and see the diff of files (
gitin status
then pressenter
to see diff orspace
to stage) - Commit/amend changes (
gitin status
then pressc
to commit orm
to amend) - Interactive hunk staging (
gitin status
then pressp
) - Explore branches with useful filter options (e.g.
gitin branch
pressenter
to checkout) - Convenient UX and minimalist design
- See more options by running
gitin --help
, also you can get help for individual subcommands (e.g.gitin log --help
)
Installation
- Linux and macOS are supported, Windows is not at the moment.
- Download latest release from here
- Or, manually download it with
go get -d github.com/isacikgoz/gitin
cd
into$GOPATH/src/github.com/isacikgoz/gitin
- make would expect a built libgit2 library to make a static link. So, when you run
make
command, you should be able to build libgit2 at your$GOPATH/pkg/mod/gopkg.in/libgit2/git2go.../vendor/libgit2/build
directory. This issue has been shown up after go modules. - build with
make install
(cmake
andpkg-config
are required)
Mac/Linux using brew
The tap is recently moved to new repo, so if you added the older one (isacikgoz/gitin), consider removing it and adding the new one.
brew tap isacikgoz/taps
brew install gitin
Usage
usage: gitin [<flags>] <command> [<args> ...]
Flags:
-h, --help Show context-sensitive help (also try --help-long and --help-man).
-v, --version Show application version.
Commands:
help [<command>...]
Show help.
log
Show commit logs.
status
Show working-tree status. Also stage and commit changes.
branch
Show list of branches.
Environment Variables:
GITIN_LINESIZE=<int>
GITIN_STARTINSEARCH=<bool
GITIN_DISABLECOLOR=<bool>
GITIN_VIMKEYS=<bool>
Press ? for controls while application is running.
Configure
- To set the line size
export GITIN_LINESIZE=5
- To set always start in search mode
GITIN_STARTINSEARCH=true
- To disable colors
GITIN_DISABLECOLOR=true
- To disable h,j,k,l for nav
GITIN_VIMKEYS=false
Development Requirements
- Requires gitlib2 v27 and
git2go
. See the project homepages for more information about build instructions. For gitin you can simply;- macOS:
- install libgit2 via
brew install libgit2
(consider that libgit2.v27 is required)
- install libgit2 via
- Linux and macOS(if you want to build your own):
- download git2go;
go get -d gopkg.in/libgit2/git2go.v27
- make sure you have
cmake
,pkg-config
andlibssl-dev
installed cd
into$GOPATH/src/gopkg.in/libgit2/git2go.v27
- initialize submodules by running
git submodule update --init
- change the libigt2 version to your version (in this case its 0.27) in the install script (e.g.
nano script/install-libgit2.sh
orvim script/install-libgit2.sh
) and changeLG2VER
to 0.27.0 - run the script
./script/install-libgit2.sh
- download git2go;
- macOS:
- After these you can download it with
go get github.com/isacikgoz/gitin
cd
into$GOPATH/src/github.com/isacikgoz/gitin
and start hacking
Contribution
- Contributions are welcome. If you like to please refer to Contribution Guidelines
- Bug reports should include descriptive steps to reproduce so that maintainers can easily understand the actual problem
- Feature requests are welcome, ask for anything that seems appropriate
Credits
See the credits page