Release notes

Note that all user-defined commands are now executed at the repository root instead of whatever subdirectory Tig was started in. (GH #412)

Remove cmdline-args option to avoid problems where setting it in ~/.tigrc potentially breaks other views due to its "context-sensitive" nature, where a git-log option maybe cause git-grep to fail. (GH #431)

Use .mailmap to show canonical name and email addresses, off by default. Add set mailmap = yes to ~/.tigrc to enable. (GH #411)

Highlight search results, configurable via search-result color. (GH #493)

Wrap around when searching, configurable via wrap-search setting.

Populate %(file) with file names from diff stat. (GH #404)

tig --merge implies --boundary similar to gitk.

Expose repository variables to external commands, e.g. %(repo:head) gives the branch name of the current HEAD and %(repo:cdup) for the repo root path.

Add make uninstall. (GH #417)

Add ZSH completion file (based on Bash completion) (GH #433)

Expose the text of the currently selected line as the %(text) (GH #457)

Allow users to specify rev arguments to blame (GH #439)

Update OSX make config to find brew installed ncurses

Add sample git-flow keybinding (GH #421)

Add chocolate theme (GH #432)

Show stash diffs. (GH #328)

Make user tigrc location configurable. (GH #479)

Compact relative date display mode. (GH #331)

Add date column option controlling whether to show local date.

Move to parent commit in the main view. (GH #388)

Add :goto <rev> prompt command to go to a git-rev-parse`d revision, e.g. `:goto some/branch or :goto %(commit)^2.

Respect the XDG standard for configuration files. (GH #513)

Resolve diff paths when diff.noprefix is true. (GH #487, #488)

Support for custom strftime(3) date formats, e.g.:

set main-view-date = custom
set main-view-date-format = "%Y-%m-%d"

Prevent staged rename from displaying unstaged changes (GH #472, #491)

Fix corrupt chunk header during staging of single lines. (GH #410)

Fix out of bounds read in graph-v2 module. (GH #402)

Add currently checked out branch to %(branch). (GH #416)

Size diff stats correctly for split views.

Fix git-worktree support by using git-show-ref. (GH #437)

Add currently checked out branch to %(branch) (GH #416)

Fix segfault when hitting return in empty file search (GH #464)

Remove separator on horizontal split when switching from vertical split

Do not expand --all when parsing %(revargs) (GH #442, #462)

Fix exit when the main view is reloaded due to option toggling. (GH #470)

Expand all whitespace and control characters to spaces. (GH #485)

Restore ability to unbind a default keybinding with none. (GH #483)

Fix blob view to honor the wrap-lines setting.

Add support for key combos. (GH #67)

See contrib/vim.tigrc for Vim-like keybindings. (GH #273, #351)

Add GitHub inspired file finder to search for and open any file. (GH #342)

Add search keymap for navigation file finder search results.

Fix display of multiple references per commit. (GH #390, #391)

Sync the prompt’s cursor position with readline’s internal position. (GH #396)

Keep unstaged changes view open after an staging command. (GH #399)

Improve C99 compliance so Tig compiles with the native compilers on Solaris (SunStudio cc) and AIX (xlc). (GH #380)

Add move-half-page-up and move-half-page-down actions. (GH #323)

Preserve the cursor position when changing the diff context.

Show Unstaged changes above Staged changes in the main view. (GH #383)

Add :exec <flags><args...> prompt command to execute commands.

Add shorthand for changing the view settings of a single column, eg. set main-view-author = short. (GH #318)

Show better diff context info in the stage view.

Add %(lineno) state variable. (GH #304)

Use hash table to speed up refs lookup. (GH #350)

Show the file path in the blob view when available.

Use set commit-order = default to use Git’s default commit order, even when the commit graph is enabled. The option will turn off automatic enabling of --topo-order when the graph is shown in the main view. (GH #310, #324)

Speed up the diff view in large repos by loading git-describe info after the diff content has been read. (GH #324)

Add the old graph rendering as an option. (GH #310, #324)

Add main-options setting for specifying default main view options. Example: set main-options = --max-count=1000. (GH #368)

See contrib/large-repo.tigrc for settings that will help to speed up Tig in large repos. (GH #368)

Add :save-options <file> prompt command to save config to file. (GH #315)

Update manual to reflect default keybinding changes. (GH #325)

Fix graph support for --first-parent. (GH #326)

Fix off-by-one error when opening editor from the grep view.

Fix status on-branch information.

Fix main view to handle the case when git-log doesn’t find any commits.

Fix corner case when parsing diff chunk when lines information is missing.

Ensure main view changes commits are shown right before the current HEAD.

Fix rendering of boundary commits.

Fix compilation with GNU Make 3.80 by removing $(abspath). (GH #362)

Fix config parsing to support shell-like quoting in user-defined command, e.g. bind generic <Ctrl-f> :!git log -G"%(prompt Prompt: )" (GH #371)

Make diff meta information colors more consistent with Git. (GH #375)

Fix segfault when updating changes in a maximized stage view opened via the main view. (GH #376)

Handle line number configs where the interval is not specified. (GH #378)

Fix display of error messages during startup. (GH #385)

Show untracked files outside the current directory like git-status. (GH #230)

Add :save-display <file> prompt command to save the current display.

Add :script <file> prompt command for scripting the Tig UI.

Add test framework and convert existing tests to use it.

Add command-line option for starting in refs view: tig refs. (GH #309)

Make blame commit ID colors stable across reloads. (GH #303)

Increase blame ID and graph rendering color palette to 14 colors.

New setting split-view-width controls the width for vertical splits. It takes the width of the right-most view either as a number or a percentage.

Expose settings holding command line argument lists: file-args, rev-args, and cmdline-args. They are mainly intended for testing purposes but also allows to change the filtering arguments dynamically. (GH #306)

Add log-options setting for specifying default log view options. Example: set log-options = --pretty=fuller.

Use option specific view flags to reload view after :set commands.

Refresh the current view when returning from an external command and refresh-mode=after-command. (GH #289)

Fix readline completion.

Fix / to find-next when readline support is enabled. (GH #302)

Fix readline prompt to correctly handle UTF-8 characters.

Add warnings for more obsolete actions and colors.

Fix passing of commit IDS via stdin to the main view.

Fix commit title overflow drawing for multibyte text. (GH #307)

Fix installation directory permissions.

Handle binary files matches reported by git-grep.

Toggling of "args"-typed options without any arguments will clear the current arguments. Example: :toggle blame-options.

Detect custom pretty.format settings that break the log view and fallback to use the medium format. (GH #225)

Fix invocation of git-diff for the blame view’s line tracking. (GH #316)

Fix blame completion of directory names. (GH #317)

Fix display of conflicts in the main view when show-changes is enabled.

Fix off-by-one error when displaying line numbers in the grep view.

When showing the commit graph ensure that either topo, date or author-date commit order is used. (Debian #757692) (GH #238)

Use git-status for diffing the index.

Group toggle options together in the help view.

Fix refs, main and grep loading when gui.encoding is set. (GH #287)

Ignore gui.encoding and i18n.commitencoding when set to UTF-8.

Add work-around for missing strndup() on Mac OS X v10.6. (GH #286)

Fix spurious abbreviation of author names. (GH #288)

Don’t show empty action groups in the help view.

Fix compilation in watch.c.

Fix parsing of key bindings mapped to ^ and <. (GH #280, #282)

Add .adoc extension to AsciiDoc files so they show correctly on GitHub. This includes README, INSTALL, and NEWS and files in doc/ directory.

BUGS file has been merged into README.adoc.

Default keybindings have been moved to a system-level tigrc file, which is installed to $/etc by default. The content of the tigrc file is included inside the binary as a fall-back. Pass NO_BUILTIN_TIGRC=y to not include the system tigrc content and reduce the size of the binary.

The example contrib/tigrc file (made obsolete by tigrc) has been removed.

Source files have been moved to src and include and tig.c was split up.

Build output is less verbose by default; use make V=1 for old output.

In preparation for key combo support, key mappings for symbolic keys (e.g. Up and Down) must now start with < and end with >, e.g. <Up> and <Down>. Furthermore, escape key combos must now use <Esc>key instead of ^[key, and control key mappings must now use <Ctrl-key> instead of ^key.

Only use diff-options for the diff view and introduce %(cmdlineargs) to hold non-file and non-revision flags passed on the command line. Affects all user-defined commands that expect %(diffargs) to hold both diff-options arguments and those passed on the command line. (GH #228)

Remove built-in keybinding for git gc. Add the following line to ~/.tigrc to restore it: bind generic G ?git gc.

To support view specific colors, . can no longer be used interchangeably with - and _ in settings names and in particular color names.

Replace stage-next action with prompt command using a predefined search (see below) and add binding (@ by default) to also work in the diff view.

Most view display options must now be set via the new *-view options in tigrc. Existing options are no longer recognized, but a warning is shown.

Remap default bindings to have more consistent convention: use lower-case keys primarily for view switching and non-destructive actions, use upper-case keys for view-specific actions including user-defined commands. To preserve old default key bindings see contrib/bindings-v1.x.tigrc. (GH #257)

Add mouse support: scroll view, click line to move cursor, double click line (or click again) to "Enter" cursor line, e.g. open commit diff. Disabled by default, since it makes text selection less intuitive. If you enable this remember to hold down Shift (or Option on Mac) when selecting text.

Rewrite and improve the rendering of the commit graph. (GH #144, #46)

Add completion and history support to the prompt via readline. (GH #185)

Options can be configured and toggled individually for each view. Use the new view settings to configure the order and display options for each view columns. See system tigrc and tigrc(5) for examples. (GH #89, #222)

Add grep view as a front-end to git-grep(1): tig grep -p strchr. From within Tig, the key for switching or grepping is bound to g by default.

Rename branch view to refs view and show tags. (GH #134)

Add main view pager mode that reads git-log’s --pretty=raw data from stdin, e.g. git reflog --pretty=raw | tig --pretty=raw.

Add support for --graph and highlight diff stats in the log view.

Add default command bindings: ! to delete branch, ! to drop stash.

Add stage-split-chunk action for splitting chunks in the stage view. Bound to \ by default. (GH #107)

Add back action bound to < by default, which will return the blame view to the previous revision and line after moving e.g. to the parent. (GH #124)

Auto-refresh views based on watched repository changes. Configure by setting refresh-mode to manual, auto, after-command, or periodic. (GH #190)

All default settings are in well-documented system tigrc.

Add :toggle prompt command to manipulate options using keybindings. For example: bind diff D :toggle diff-options --patience --notes. (GH #69)

Add a new "auto" value for the vertical-split option to let Tig choose the split orientation (this is the new default behavior). Can be toggled.

Make it possible to toggle the display of files in untracked directories.

Allow Tig to be started with no default configuration by specifying an alternative system tigrc file, e.g.: TIGRC_SYSTEM=~/.tigrc.safe tig. Set TIGRC_SYSTEM to the empty string to use built-in configuration instead of

Key mappings can contain UTF-8 multibyte unicode keys.

Warn about conflicting keybindings using Ctrl, e.g. <Ctrl-f> and <Ctrl-F>. (GH #218)

Extend key bindings for prompt commands (ie. bind <keymap> <key> :<prompt>) to support predefined searches, eg.: bind stage 2 :?^@@.

Git color mappings can be configured in tigrc.

More informative configuration error messages.

Make reference label formatting configurable, for example: set reference-format = (branch) <tags> remote. (GH #201)

Adjust author width and other view columns automatically. (GH #49)

Support view specific colors: color stage.diff-add yellow default.

Copy -S, -G and --grep= pattern to search buffer so find-next and find-prev work as expected.

Optionally specify custom prompt for %(prompt) in shell commands, e.g. bind main B ?git checkout -b "%(prompt Enter new branch name: )".

Add %(remote) and %(tag) symbols to complement %(branch).

User-defined commands can now be prefixed with any of the supported flags, e.g. ?git checkout -b %(branch).

Open editor at line number for combined diffs e.g. diffs of unmerged files.

Add build configuration for Cygwin (OS name: CYGWIN_NT-6.1). (GH #92)

Document the Git commands supported by the pager mode. (GH #1) system tigrc configuration. (GH #235)

Fix stash diff display when reloading the stash view after a deleting.

Set the commit reference when opening the blame view from the blob view.

Correctly identify and highlight the remote branch tracked by HEAD.

Pass --no-color after user defined arguments to ensure that colors do not break the output parsing. (GH #191)

Close stdin when pager mode is not supported.

Show newly created branches in the main view. (GH #196)

File with 0 changes breaks diffstat highlighting (GH #215)

Update %(branch) variable in the main view. (GH #223)

Disable graph rendering when either of --reverse, -S, -G, and --grep are passed to the main view. (GH #127)

Only refresh views that support it.

Fix author and date annotation of renamed entries in the tree view.

Fix use of unsafe methods in the signal handler. (GH #245)

Fix rendering in non-UTF8 terminals.

Fix stage-update-line by rewriting the diff chunk containing the line instead of using --unidiff-zero and a diff context of zero. (GH #130)

Fix status-update to work for untracked directories. (GH #236)

Don’t pass log parameters given on the command line to the diff view.

Move manual and man pages to doc/ directory and rename AsciiDoc files to have .asciidoc as the extension to make them render on GitHub.

Show blob sizes in the tree view either as bytes or using binary unit prefixes. Example: set show-file-size = units. (GH #163)

Reduce main view memory usage and startup time, especially when revision graph rendering is disabled. (GH #160)

Fix submodule-related setup to check for non-zero return value from setenv(). (GH #188)

Tig now has its own tag on Stack Overflow, where users are invited to ask questions: http://stackoverflow.com/questions/tagged/tig

Prompt commands can be bound to keys. For example: bind diff F :set diff-options = --full-diff. (GH #69, #116)

Add a diff-options setting for specifying default diff options. Example: set diff-options = --patience. (GH #116)

Options in diff-options and blame-options matching Tig browsing state variables are replaced.

Show diff stats as wide as the terminal. (GH #109)

Show line numbers in the branch view. (GH #135)

Add toggles for showing author email or email user names. (GH #115)

Open editor at the selected line by prefixing the file argument with +<lineno>. Tested in vi, Vim, Emacs, Nano, Gedit, Geany. Disable by adding set editor-line-number = no to ~/.tigrc. (GH #118, #119)

Add toggle-files to control whether to show full commit diff or only the diff concerning the currently selected file, e.g. for blame.

Optionally highlight exceeding characters in long commit titles. The default title max width is 50 characters. Customize using: set title-overflow = 50 (GH #125)

Add +ESC key bindings. Example: bind generic ^[v move-page-up (GH #120)

Create temporary files in TMPDIR, TEMP, or TMP before defaulting to /tmp.

Reenable tig log as a subcommand. (GH #146)

Enable tilde expansion in ~/.tigrc "source" commands. (GH #168)

Introduce the stash view, bound to the y keybinding. (GH #169, #174)

Fix blame and status to work in directories starting with a dot. (GH #172)

Reload current branch name when reloading the status view. (GH #93)

Fix compile errors on old Solaris. (GH #97)

Reload HEAD info when reloading the stage view. (GH #104, #93)

Fix disappearing branch labels after external commands. (GH #148)

Fix diff view display for staged/unstaged changes when using d.

Fix display of status messages when toggling view options. (GH #111)

Fix illegal memory access. (GH #98)

Fix display of all branches label in repos with short branch names.

Fix rendering glitch for branch names.

Do not apply diff styling to untracked files in the stage view. (GH #153)

Fix tree indentation for entries containing combining characters. (GH #170)

Ignore unrepresentable characters when transliterating text for rendering.

Transliterate text to output encoding before trimming it to avoid misalignment. (GH #86)

Introduce a more natural context-sensitive log display. (GH #155)

Disable diff move/copy detection by default, boosting diff performance on larger projects. Use git config diff.renames option (Git-wide) to set your preferred behavior. Environment variable TIG_DIFF_OPTS can be used to restore the old behavior.

Fix manual keybinding for stage-single-line. (GH #108)

Values set for author-width and filename-width will result in widths one character bigger than previously.

Typing a text in the prompt will be interpreted as a Tig command. Prefixing the command with a ! will execute this system command in an external pager. Entering a single key will execute the corresponding key binding.

Basic support for wrapping long line in pager, diff, and stage views. Enable using: set wrap-lines = yes. (GH #2)

User-defined commands prefixed with a ? means prompt before execution. Example: bind main B !?git rebase -i %(commit).

User-defined commands prefixed with a < means exit after execution. Example: bind main C !<git commit. (GH #66)

User-defined commands are executed unquoted to support shell commands. Example: bind generic I !@sh -c "echo -n %(commit) | xclip -selection c". (GH #65)

Configure case-insensitive searches using: set ignore-case = yes.

Add "deleted mode" line type for better diff coloring.

Open editor when requesting edit action from within a file diff.

Update AX_WITH_CURSES to build under Cygwin.

Improve tigrc(5) documentation. (Debian #682766)

Allow to build on Mac OS 10.7 without the configure script. (GH #25)

Add option to split the view vertically instead of horizontally. Example: ‘set vertical-split = yes’. (GH #76)

Add show-id and id-width options to configure the display of commit IDs in the main view and ID width in the blame view. (GH #77)

Allow to override Git based encoding to UTF-8 by setting i18n.commitencoding or gui.encoding.

Improve autobuild support to track generated files and work with autoreconf 2.61.

Commit IDs are read from stdin when --stdin is given; works for main and diff view, e.g. tig --no-walk --stdin < cherry-picks.txt.

Add option to disable focusing of the child view when it’s opened. Disable using: set focus-child = no. (GH #83)

Allow to open blob related with added content in a diff. (GH #91)

Fix commit graph regression when a path spec is specified. (GH #53)

Main view: only show staged/unstaged changes for the current branch.

Support submodules created with current version of git. (GH #54)

Fix diff status message for file diffs with no content changes.

Fix parent blaming when Tig is launched in subdirectory. (GH #70)

Do not show deleted branch when reloading the branch view.

Use git-log(1)s default commit ordering. The old behavior can be restored by adding set commit-order = topo to ~/.tigrc.

Support staging of single lines. Bound to 1 default. (GH #21)

Use +<lineno> to open the initial view at an arbitrary line. (GH #20)

Add show-notes ~/.tigrc option. Notes are displayed by default.

Support jumping to specific SHAs in the main view.

Decorate replaced commits.

Display line numbers in main view.

Colorize binary diff stats. (GH #17)

Custom colorization of lines matching a string prefix (GH #16). Example configuration: color "Reported-by:" green default

Use Git’s color settings for the main, status and diff views. Put set read-git-colors = no in ~/.tigrc to disable.

Handle editor options with multiple arguments. (GH #12)

Show filename when running tig blame with copy detection. (GH #19)

Use source <path> command to load additional files from ~/.tigrc

User-defined commands prefixed with @ are run with no console output, e.g.

bind generic 3 !@rm sys$command

Make display of space changes togglable in the diff and stage view. Bound to W by default.

Use per-file encoding specified in gitattributes(5) for blobs and unstaged files.

Obsolete commit-encoding option and pass --encoding=UTF-8 to revision commands.

Main view: show uncommitted changes as staged/unstaged commits. Can be disabled by putting set show-changes = no in ~/.tigrc.

Add %(prompt) external command variable, which will prompt for the argument value.

Log information about Git commands when the TIG_TRACE environment variable is set. Example: TIG_TRACE=/tmp/tig.log tig

Branch view: Show the title of the last commit.

Increase the author auto-abbreviation threshold to 10. (GH #49)

For old commits show number of years in relative dates. (GH #50)

Fix navigation behavior when going from branch to main view. (GH #38)

Fix segfault when sorting the tree view by author name.

Fix diff stat navigation for unmodified files with stat changes.

Show branches/refs which names are a substring of the current branch.

Stage view: fix off-by-one error when jumping to a file in a diff with only one file.

Fix diff-header colorization. (GH #15)

Remove support for the deprecated TIG_{MAIN,DIFF,LOG,TREE,BLOB}_CMD environment variables.

Pressing enter on diff stat file lines will jump to file’s diff.

Naïvely color blame IDs to distinguish lines.

Document palette color options used for revision graph and blame IDs.

Add support for blaming diff lines.

Add diff-context option and bindings to increase the diff context in the diff and stage view.

(GH-6) Make blame configurable via extra options passed from the command line and blame-options setting from ~/.tigrc. For example:

set blame-options = -C -C -C

Expand browsing state variables for prompt. (LP #694780, Debian #635546)

Fix segfault when sorting the branch view by author.

Expand %(directory) to . for the root directory. (GH-3)

Accept utf-8 for the line-graphics option as indicated in the docs.

Use erasechar() to check for the correct backspace character.

Start rewrite of the revision graph renderer. Three modes are supported UTF-8, ncurses line graphics, and ASCII. Also, enable revision graph rendering by default.

Fix ncurses 5.8 issue by passing non-zero column size to newwin().

Fix opening of diffs when browsing branches.

Fix regression causing empty tree view.

Fix set_tabsize() compile error for older versions of ncurses.

Add scroll-first-col ac