#git #editor #tool #cli #rebase

app git-interactive-rebase-tool

Full feature terminal based sequence editor for git interactive rebase. Written in Rust using ncurses.

6 releases (2 stable)

✓ Uses Rust 2018 edition

1.1.0 Aug 20, 2019
1.0.0 Apr 10, 2019
0.7.0 Oct 28, 2018
0.6.0 Feb 13, 2018
0.4.0 Feb 11, 2017

#22 in Command line utilities

Download history 7/week @ 2019-05-07 12/week @ 2019-05-14 17/week @ 2019-05-21 16/week @ 2019-05-28 5/week @ 2019-06-04 7/week @ 2019-06-11 17/week @ 2019-06-18 21/week @ 2019-06-25 59/week @ 2019-07-02 14/week @ 2019-07-09 9/week @ 2019-07-16 8/week @ 2019-07-30 18/week @ 2019-08-06 2/week @ 2019-08-13

64 downloads per month

GPL-3.0-or-later

130KB
4K SLoC

Crates.io Build Status Build status GitHub license

Git Interactive Rebase Tool

Native cross-platform full feature terminal based sequence editor for interactive rebase in Git 1.7.8+. Written in Rust using ncurses.

Git Interactive Rebase Tool

This is the documentation for version 1.1.0. For the previous release please use the 1.0.0 documentation.

Install

Configure

Most systems

git config --global sequence.editor interactive-rebase-tool

Windows

git config --global sequence.editor "'C:/path/to/interactive-rebase-tool'"

Usage

interactive-rebase-tool <rebase-todo-filepath>
interactive-rebase-tool --help
interactive-rebase-tool --version

Getting Help

The tool has built-in help that can be accessed by hitting the ? key.

Default Key Bindings

Key bindings can be configured, see configuration for more information.

Key Mode Description
Up All Move selection up
Down All Move selection down
Page Up All Move selection up five lines
Page Down All Move selection down five lines
q Normal Abort interactive rebase
Q Normal Immediately abort interactive rebase
w Normal Write interactive rebase file
W Normal Immediately write interactive rebase file
? All Show help
c Normal Show commit information
j All Move selected commit(s) down
k All Move selected commit(s) up
b Normal Toggle break action
p All Set selected commit(s) to be picked
r All Set selected commit(s) to be reworded
e All Set selected commit(s) to be edited
s All Set selected commit(s) to be squashed
f All Set selected commit(s) to be fixed-up
d All Set selected commit(s) to be dropped
E Normal Edit the command of an exec action
V All Enter and exit visual mode

Temporary Override

You can temporarily use a different sequence editor by using the GIT_SEQUENCE_EDITOR environment variable:

GIT_SEQUENCE_EDITOR=emacs git rebase -i [<upstream> [<branch>]]

Configuration

The tool can be configured using the git config command. Invalid values are ignored and the default used instead. String values are case-insensitive.

Example

git config --global interactive-rebase-tool.foregroundColor black

Options

Key Default Type Description
autoSelectNext false bool If true, auto select the next line after action modification
breakColor white Color Color used for the break action
diffAddColor green Color Color used for lines and files added in a diff
diffChangeColor yellow Color Color used for lines and files changed in a diff
diffRemoveColor red Color Color used for lines and files removed in a diff
dropColor red Color Color used for the drop action
editColor blue Color Color used for the edit action
errorColor red Color Color used for showing error messages
fixupColor magenta Color Color used for the fixup action
foregroundColor white Color Color used for most text and the UI
indicatorColor cyan Color Color used for text the indicates or needs to standout
inputAbort q String Key for abort rebase with prompt
inputActionBreak b String Key for setting action to rebase
inputActionDrop d String Key for setting action to drop
inputActionEdit e String Key for setting action to edit
inputActionFixup f String Key for setting action to fixup
inputActionPick p String Key for setting action to pick
inputActionReword r String Key for setting action to reword
inputActionSquash s String Key for setting action to squash
inputConfirmNo n String Key for rejecting a confirmation
inputConfirmYes y String Key for confirming a confirmation
inputEdit E String Key for entering edit mode
inputForceAbort Q String Key for forcing an abort of the rebase
inputForceRebase W String Key for forcing a rebase
inputHelp ? String Key for showing the help
inputMoveDownStep PageDown String Key for moving the cursor down by a large step
inputMoveDown Down String Key for moving the cursor down
inputMoveLeft Left String Key for moving the cursor left
inputMoveRight Right String Key for moving the cursor right
inputMoveSelectionDown j String Key for moving the selected line(s) down
inputMoveSelectionUp k String Key for moving the selected line(s) up
inputMoveUp Up String Key for moving the cursor up
inputMoveUpStep PageUp String Key for moving the cursor up by a large step
inputOpenInExternalEditor ! String Key for opening the external editor
inputRebase w String Key for rebasing with confirmation
inputShowCommit c String Key for showing the selected commit
inputToggleVisualMode v String Key for toggling visual mode
pickColor green Color Color used for the pick action
rewordColor yellow Color Color used for the reword action
squashColor cyan Color Color used for the squash action
verticalSpacingCharacter ~ String Vertical spacing character. Can be set to an empty string.

Special Keys

Key Description
PageDown Page Down key
Down Down arrow key
Left Left arrow key
Right Right arrow key
Up Up arrow key
PageUp Page Up key

Valid Color Values

The valid colors are the eight original 8 ANSI colors. They are black, blue, cyan, green, magenta, red, white and yellow. Each terminal controls the exact color for these color names.

Development

Install Rust

To start developing the project you will need to install Rust, which can generally be done using rustup.

Setup

Debian and derivatives

You will need build-essential and libncurses5-dev to build the project. Additionally, you will need pkg-config and liblzma-dev if you wish to build a release. They can be installed using apt-get:

sudo apt-get install build-essential libncursesw5-dev
sudo apt-get install pkg-config liblzma-dev

Build and run

Use cargo to build and run the project. From the project root run:

# only build
cargo build --release
# build and run
cargo run <path-to-git-rebase-todo-file>

Release

Install Cargo Deb
cargo install cargo-deb
Building
cargo build --release
cargo deb

A deb file will be written to target/debian/interactive-rebase-tool_*.deb.

TODO

  • Full support for exec action
  • Insert action
  • Configure key bindings

Related Projects

License

Git Interactive Rebase Tool is released under the GPLv3 license. See LICENSE.

See Third Party Licenses for licenses for third-party libraries used by this project.

Dependencies

~11MB
~248K SLoC