git-iblame

An enhanced git blame command line tool.

The git-iblame allows you to find changes to the lines of your interests, not only the last change as git blame can do, but also all the past changes, up to the initial commit.

Features:

• Moving the cursor to the line of your interests.
• Traversing to older or newer trees of the line interactively.
• Seeing the commit or the diff of the line at any trees.

The git-iblame is built for speed. Computing all the history of a file is an expensive task, especially when the repository is large. The git-iblame can make it instant.

To make the traversals of the history instant, the git-iblame has its own file history engine. This engine is built on top of the fundamental git operations provided by the git2/libgit2, without using the logic in the git blame.

Also to make the traversals even more comfortable, the engine runs in background. Old annotations which takes time to read from the disk come up incrementally while you are browsing.

Re-computing the hisotry annotations for different trees is also instant. The git-iblame can compute the history for different trees instantly from its own data structure in memory, unlike the git blame which needs to read from the disk each time it is ran.

Install

Prerequisites

• Install Rust if it's not installed yet.

From crates.io

cargo install git-iblame

From github

cargo install --git https://github.com/kojiishi/git-iblame

From local checkout

After changing the current directory to the checkout directory:

cargo install --path .

Usages

To start an interactive git blame session, specify the path of the file in a git repository.

git-iblame <path-to-file>

The output is similar to git blame, with the current line highlighted. You can move the current line, or traverse the git history of the current line.

Please see the help by pressing the h key for the full commands and their key bindings. Major commands are:

• h: Show the help.
• q: Quit the program.
• s: Show the commit at the current line.
• d: Show the diff of the current file of the commit at the current line.
• c: Copy the hash of the current line commit to the clipboard.
• → (Right) or Enter: Traverse to the parent commit of the commit at the current line.
• ← (Left) or Backspace: Undo the last traversal; i.e., traverse back to the last newer tree.