NAME
tigrc - Tig configuration fileSYNOPSIS
set variable = value bind keymap key action color area fgcolor bgcolor [attributes] source path
DESCRIPTION
You can permanently set an option by putting it in the ~/.tigrc file. The file consists of a series of commands. Each line of the file may contain only one command. Commands can span multiple lines if each line is terminated by a backslash ( \) character.GIT CONFIGURATION
Alternatively to using ~/.tigrc, Tig options can be set by putting them in one of the Git configuration files, which are read by Tig on startup. See git-config(1) for which files to use. The following example show the basic syntax to use for settings, bindings and colors.[tig] show-changes = true [tig "color"] cursor = yellow red bold [tig "bind"] generic = P parent
Colors for the various UI types. Can be
configured via the git-colors setting.
core.abbrev
The width of the commit ID. See also
id-width option.
core.editor
The editor command. Can be overridden by
setting TIG_EDITOR or GIT_EDITOR.
core.worktree
The path to the root of the working
tree.
gui.encoding
The encoding to use for displaying of file
content.
i18n.commitencoding
The encoding used for commits. The default is
UTF-8.
SET COMMAND
A few selective variables can be configured via the set command. The syntax is:set variables = value
set commit-order = topo # Order commits topologically set git-colors = no # Do not read Git's color settings. set horizontal-scroll = 33% # Scroll 33% of the view width set blame-options = -C -C -C # Blame lines from other files # Wrap branch names with () and tags with <> set reference-format = (branch) <tag> # Configure blame view columns using command spanning multiple lines. set blame-view = \ date:default \ author:abbreviated \ file-name:auto \ id:yes,color \ line-number:yes,interval=5 text
[tig] line-graphics = no # Disable graphics characters tab-size = 8 # Number of spaces per tab
To set a bool variable to true use either
"1", "true", or "yes". Any other value will set
the variable to false.
Valid int values
A non-negative integer.
Valid string values
A string of characters. Optionally, use either
' or " as delimiters.
Valid mixed values
These values are composites of the above
types. The valid values are specified in the description.
Variables
The following variables can be set: diff-options (string)A space-separated string of diff options to
use in the diff view. git-show(1) is used for formatting and always passes
--patch-with-stat. Can control display of commit header metadata, passing
option --format. This option overrides any options specified in the
TIG_DIFF_OPTS environment variable (described in tig(1)), but is itself
overridden by diff flags given on the command line invocation.
blame-options (string)
A space-separated string of default blame
options. Can be used for telling git-blame(1) how to detect the origin of
lines. The options are ignored when Tig is started in blame mode and given
blame options on the command line.
log-options (string)
A space-separated string of default options
that should be passed to the git-log(1) command used by the log view. Options
can be overridden by command line options. Used internally override custom
‘pretty.format’ settings that break the log view.
main-options (string)
A space-separated string of default options
that should be passed to the git-log(1) command used by the main view. Options
can be overridden by command line options.
reference-format (string)
A space-separated string of format strings
used for formatting reference names. Wrap the name of the reference type with
the characters you would like to use for formatting, e.g. [tag] and
<remote>. If no format is specified for local-tag, the format for tag is
used. Similarly, if no format is specified for tracked-remote the remote
format is used. Prefix with hide: to not show that reference type, e.g.
hide:remote. Supported reference types are:
line-graphics (mixed) [ascii|default|utf-8|auto|<bool>]
•head : The current HEAD.
•tag : An annotated tag.
•local-tag : A lightweight tag.
•remote : A remote.
•tracked-remote : The remote tracked by
current HEAD.
•replace : A replaced reference.
•branch : A branch.
•stash : The stash.
•other : Any other reference.
What type of character graphics for line
drawing. "auto" means "utf-8" if the locale is UTF-8,
"default" otherwise.
truncation-delimiter (mixed) [utf-8|<string>]
A single character to draw where columns are
truncated. The default is "~". The special value "utf-8"
refers to the character "..." ("Midline Horizontal
Ellipsis").
horizontal-scroll (mixed)
Interval to scroll horizontally in each step.
Can be specified either as the number of columns, e.g. 5, or as a
percentage of the view width, e.g. 33%, where the maximum is 100%. For
percentages it is always ensured that at least one column is scrolled. The
default is to scroll 50% of the view width.
git-colors (list)
A space-separated list of
"key=value" pairs where the key is a Git color name and the value is
a Tig color name, e.g. "branch.current=main-head" and
"grep.filename=grep.file". Set to "no" to disable.
show-notes (mixed) [<reference>|<bool>]
Whether to show notes for a commit. When set
to a note reference the reference is passed to git show --notes=. Notes are
enabled by default.
show-changes (bool)
Whether to show staged and unstaged changes in
the main view.
show-untracked (bool)
Whether to show also untracked changes in the
main view.
vertical-split (mixed) [auto|<bool>]
Whether to split the view horizontally or
vertically. "auto" (which is the default) means that it will depend
on the window dimensions. When true vertical orientation is used, and false
sets the orientation to horizontal.
split-view-height (mixed)
The height of the bottom view in a
horizontally split display. Can be specified either as the number of rows,
e.g. 5, or as a percentage of the view height, e.g. 80%, where
the maximum is 100%. It is always ensured that the smaller of the views is at
least four rows high. The default is 67%.
split-view-width (mixed)
Width of the right-most view in a vertically
split display. Can be specified either as the number of column, e.g. 5,
or as a percentage of the view width, e.g. 80%, where the maximum is
100%. It is always ensured that the smaller of the views is at least four
columns wide. The default is 50%.
status-show-untracked-dirs (bool)
Show untracked directories contents in the
status view (analog to git ls-files --directory option). On by default.
status-show-untracked-files (bool)
Show untracked files in the status view
(mirrors Git’s status.showUntrackedFiles option). On by default.
tab-size (int)
Number of spaces per tab. The default is 8
spaces.
diff-context (int)
Number of context lines to show for
diffs.
diff-highlight (mixed)
Whether to highlight diffs using Git’s
diff-highlight program. Defaults to false. When set to true then
diff-highlight is used, else the option value is used as the path. When
this option is in effect, highlighted regions are governed by color
diff-add-highlight and color diff-del-highlight.
ignore-space (mixed) [no|all|some|at-eol|<bool>]
Ignore space changes in diff view. By default
no space changes are ignored. Changing this to "all",
"some" or "at-eol" is equivalent to passing
"--ignore-all-space", "--ignore-space" or
"--ignore-space-at-eol" respectively to git diff or git show.
Warning: when ignore-space is set to some, all or at-eol, then the
status-update and status-revert may fail when updating or
reverting chunks containing lines with space changes. Similarly,
stage-update-line may fail when updating a line adjacent to a line with
space changes
commit-order (enum) [auto|default|topo|date|author-date|reverse]
Commit ordering using the default
(chronological reverse) order, topological order, date order or reverse order.
When set to "auto" (which is the default), topological order is
automatically used in the main view when the commit graph is enabled. In
repositories with a long commit history it is advised to set this option to
"default" to speed up loading of the main view.
ignore-case (enum) [no|yes|smart-case]
Ignore case in searches.
"smart-case" ignores case if the search string doesn’t
contain any uppercase letters. By default, the search is case sensitive.
mailmap (bool)
Read canonical name and email addresses for
authors and committers from .mailmap. Off by default. See
git-shortlog(1).
wrap-lines (bool)
Wrap long lines. By default, lines are not
wrapped. Not compatible with line numbers enabled.
focus-child (bool)
Whether to focus the child view when it is
opened. When disabled the focus will remain in the parent view, avoiding
reloads of the child view when navigating the parent view. True by
default.
send-child-enter (bool)
Whether to send "enter" key presses
to the child view, even if parent view is active. When disabled the child view
has to be explicitly focused to receive the "enter" key presses. In
practice only relevant when set focus-child = no. True by default.
editor-line-number (bool)
Whether to pass the selected line number to
the editor command. The line number is passed as +<line-number> in front
of the file name. Example: vim +10 tig.c
history-size (int)
Size of the persistent ~/.tig_history file
when compiled with readline support. Default is 500. Set to 0 to
disable.
mouse (bool)
Whether to enable mouse support. Off by
default since it makes selecting text from the terminal less intuitive. When
enabled hold down Shift (or Option on Mac) to select text. Mouse support
requires that ncurses itself support mouse events.
mouse-scroll (int)
Interval to scroll up or down using the mouse.
The default is 3 lines. Mouse support requires that ncurses itself support
mouse events and that you have enabled mouse support in ~/.tigrc with set
mouse = true.
mouse-wheel-cursor (bool)
Whether to prefer moving the cursor to
scrolling the view when using the mouse wheel. Off by default. Combines well
with set mouse-scroll = 1. Mouse support requires that ncurses itself support
mouse events and that you have enabled mouse support in ~/.tigrc with set
mouse = true.
pgrp (bool)
Make tig process-group leader when starting
and clean all processes when exiting. Off by default. Do not enable this
option if you are using a Zsh version affected by zsh-workers/43379. Run xclip
with setsid to keep clipboard content after exiting tig. If you are using
git-credential-cache helper, set option credentialCache.ignoreSIGHUP.
start-on-head (bool)
Start with cursor on HEAD commit.
refresh-mode (mixed) [manual|auto|after-command|periodic|<bool>]
Configures how views are refreshed based on
modifications to watched files in the repository. When set to manual,
nothing is refreshed automatically. When set to auto, views are
refreshed when a modification is detected in another view. When set to
after-command only refresh after returning from an external command.
When set to periodic, visible views are refreshed periodically using
refresh-interval.
refresh-interval (int)
Interval in seconds between view refresh
update checks when refresh-mode is set to periodic.
file-args (args)
Command line arguments referring to files.
These are filtered using git-rev-parse(1).
rev-args (args)
Command line arguments referring to revisions.
These are filtered using git-rev-parse(1).
View settings
The view settings define the order and options for the different columns of a view. Each view setting expects a space-separated list of column specifications. Column specifications starts with the column type, and can optionally be followed by a colon (:) and a list of column options. E.g. the following column specification defines an author column displaying the author email and with a fixed width of 20 characters: author:email,width=20.# Enable both ID and line numbers in the blame view set blame-view = date:default author:full file-name:auto id:yes,color \ line-number:yes,interval=5 text # Change grep view to be similar to `git grep` format set grep-view = file-name:yes line-number:yes,interval=1 text # Show file sizes as units set tree-view = line-number:no,interval=5 mode author:full \ file-size:units date:default id:no file-name # Show line numbers for every 10th line in the pager view set pager-view = line-number:yes,interval=10 text # Shorthands to change view settings for a previously defined column set main-view-date = custom set main-view-date-format = "%Y-%m-%d %H:%M" set blame-view-line-number = no # Use Git's default commit order, even when the commit graph is enabled. set commit-order = default
line-number, text
blame-view
author, date, file-name, id, line-number,
text
grep-view
file-name, line-number, text
main-view, reflog-view
author, date, commit-title, id, line-number,
ref
refs-view
author, date, commit-title, id, line-number,
ref
stash-view
author, date, commit-title, id,
line-number
status-view
file-name, line-number, status
tree-view
author, date, id, file-name, file-size,
line-number, mode
•display (mixed)
[full|abbreviated|email|email-user|<bool>]: How to display author names.
If set to "abbreviated" author initials will be shown.
•width (int): Fixed width for
the column. When set to a value between 1 and 10, the author name will be
abbreviated to the author’s initials. When set to zero, the width is
automatically sized to fit the content.
•maxwidth (int): Maximum width
of the column. Permit automatically sizing content, up to this limit. Can be
specified either as the number of columns, e.g. 15, or as a percentage
of the view width, e.g. 20%, where the maximum is 100%.
•graph (mixed) [no|v2|v1]:
Whether to show the revision graph in the main view on start-up.
"v1" refers to the old graph rendering, which is less accurate but
faster and thus recommended in large repositories. See also the
line-graphics options.
•refs (bool): Whether to show
references (branches, tags, and remotes) in the main view. Can be
toggled.
•overflow (bool or int): Whether
to highlight text in commit titles exceeding a given width. When set to a
boolean, it enables or disables the highlighting using the default width of 50
character. When set to an int, the assigned value is used as the maximum
character width.
•display (mixed)
[relative|relative-compact|custom|default|<bool>]: How to display dates.
If set to "relative" or "relative-compact" a relative date
will be used, e.g. "2 minutes ago" or "2m". If set to
"custom", the strftime(3) string format specified in the
"format" option is used.
•local (bool): If true, use
localtime(3) to convert to local timezone. Note that relative dates always use
local offsets.
•format (string): format string
to pass to strftime(3) when custom display mode has been
selected.
•width (int): Fixed width for
the column. When set to zero, the width is automatically sized to fit the
content.
•display (mixed)
[auto|always|<bool>]: When to display file names. If set to
"auto" file names are shown only when needed, e.g. when running: tig
blame -C <file>.
•width (int): Width of the
column. When set to zero, the width is automatically sized to fit the
content.
•maxwidth (int): Maximum width
of the column. Permit automatically sizing content, up to this limit. Can be
specified either as the number of columns, e.g. 15, or as a percentage
of the view width, e.g. 20%, where the maximum is 100%.
•display (mixed)
[default|units|<bool>]: How to display file sizes. When set to
"units", sizes are shown using binary prefixes, e.g. 12524 bytes is
shown as "12.2K".
•width (int): Fixed width for
the filename column. When set to zero, the width is automatically sized to fit
the content.
•display (bool): Whether to show
commit IDs in the main view.
•width (int) : Fixed width for
the commit ID column. When unset Tig will use the value of core.abbrev
if found. See git-config(1) on how to set core.abbrev. When set to zero
the width is automatically sized to fit the content of reflog (e.g.
ref/stash@{4}) IDs and otherwise default to 7.
•display (bool): Whether to show
line numbers.
•interval (int): Interval
between line numbers.
•width (int): Fixed width for
the column. When set to zero, the width is automatically sized to fit the
content.
•display (bool): Whether to show
file modes.
•width (int): Fixed width for
the column. When set to zero, the width is automatically sized to fit the
content.
•display (bool): Whether to show
the reference name.
•width (int): Fixed width for
the column. When set to zero, the width is automatically sized to fit the
content.
•maxwidth (int): Maximum width
of the column. Permit automatically sizing content, up to this limit. Can be
specified either as the number of columns, e.g. 15, or as a percentage
of the view width, e.g. 20%, where the maximum is 100%.
•display (mixed)
[no|short|long|<bool>]: How to display the status label.
•commit-title-overflow (bool or
int): Whether to highlight commit titles exceeding a given width in the diff
view. When set to a boolean, it enables or disables the highlighting using the
default width of 50 character. When set to an int, the assigned value is used
as the maximum character width.
BIND COMMAND
Using bind commands, keys can be mapped to an action when pressed in a given key map. The syntax is:bind keymap key action
# Add keybinding to quickly jump to the next diff chunk in the stage view bind stage <Enter> :/^@@ # Disable the default mapping for running git-gc bind generic G none # User-defined external command to amend the last commit bind status + !git commit --amend # User-defined internal command that reloads ~/.tigrc bind generic S :source ~/.tigrc # UTF8-encoded characters can be used as key values. bind generic ø @sh -c "printf '%s' %(commit) | pbcopy"
[tig "bind"] # 'unbind' the default quit key binding main = Q none # Cherry-pick current commit onto current branch generic = C !git cherry-pick %(commit)
Valid keymaps are: main, diff,
log, reflog, help, pager, status,
stage, tree, blob, blame, refs,
stash, grep and generic. Use generic to set key
mapping in all keymaps (which may still be overridden by a specific view
keybinding). Use search to define keys for navigating search results
during search.
Key values
Key values should never be quoted. Use either
an ASCII or UTF8-encoded character or one of the following symbolic key names.
Symbolic key names are case insensitive and starts with "<" and
ends with ">". Use <Hash> to bind to the # key,
since the hash mark is used as a comment character. Use
<LessThan> to bind to the < key.
bind main R refresh bind main <Down> next bind main <Ctrl-f> scroll-page-down bind main <Esc>o options bind main <ShiftTab> parent
•Tig reads keystrokes via ncurses and
is subject to various limitations. See ncurses(3x) and
terminfo(5) (or termcap).
•Ctrl-m and Ctrl-i cannot be bound as
they conflict with Enter and Tab respectively.
•Case differences cannot be
distinguished in control sequences such as Ctrl-f and Ctrl-F.
•Ctrl-<Space> is typically
translated to Ctrl-@, which is available for binding.
•Only some subset of special symbolic
keys such as <ShiftTab> will be available in any given terminal
emulator.
•Ctrl-z is automatically used for
process control and will suspend Tig and open a subshell (use fg to reenter
Tig).
Actions
Actions are either specified as user-defined
commands (external or internal) or using action names as described in the
following sections.
External user-defined command
These actions start with one or more of the following option flags followed by the command that should be executed.! | Run the command in the foreground with output shown. |
@ | Run the command in the background with no output. |
+ | Run the command synchronously, and echo the first line of output to the status bar. |
? | Prompt the user before executing the command. |
< | Exit Tig after executing the command. |
> | Re-open Tig instantly in the last displayed view after executing the command. |
%(head) | The currently viewed head ID. Defaults to HEAD |
%(commit) | The currently selected commit ID. |
%(blob) | The currently selected blob ID. |
%(branch) | The currently selected branch name. |
%(remote) | The currently selected remote name. For remote branches %(branch) will contain the branch name. |
%(tag) | The currently selected tag name. |
%(refname) | The currently selected reference name including the remote name for remote branches. |
%(stash) | The currently selected stash name. |
%(directory) | The current directory path in the tree view or "." if undefined. |
%(file) | The currently selected file. |
%(file_old) | The old filename of the currently selected file. |
%(lineno) | The currently selected line number. Defaults to 0. |
%(lineno_old) | The currently selected line number, before the diff was applied. Defaults to 0. |
%(ref) | The reference given to blame or HEAD if undefined. |
%(revargs) | The revision arguments passed on the command line. |
%(fileargs) | The file arguments passed on the command line. |
%(cmdlineargs) | All other options passed on the command line. |
%(diffargs) | Options from diff-options or TIG_DIFF_OPTS used by the diff and stage view. |
%(blameargs) | Options from blame-options used by the blame view. |
%(logargs) | Options from log-options used by the log view. |
%(mainargs) | Options from main-options used by the main view. |
%(prompt) | Prompt for the argument value. Optionally specify a custom prompt using "%(prompt Enter branch name: )" |
%(text) | The text of the currently selected line. |
%(repo:head) | The name of the checked out branch, e.g. master |
%(repo:head-id) | The commit ID of the checked out branch. |
%(repo:remote) | The remote associated with the checked out branch, e.g. origin/master. |
%(repo:cdup) | The path to change directory to the repository root, e.g. ../ |
%(repo:prefix) | The path prefix of the current work directory, e.g subdir/. |
%(repo:git-dir) | The path to the Git directory, e.g. /src/repo/.git. |
%(repo:worktree) | The worktree path, if defined. |
%(repo:is-inside-work-tree) | Whether Tig is running inside a work tree, either true or false. |
# Save the current commit as a patch file when the user selects a commit # in the main view and presses 'S'. bind main S !git format-patch -1 %(commit) # Create and checkout a new branch; specify custom prompt bind main B ?git checkout -b "%(prompt Enter new branch name: )" # Show commit statistics for the author under the cursor bind main U +sh -c 'git --no-pager shortlog -s --author="$(git show -s --format=%aE %(commit))" </dev/tty'
bind generic I @sh -c "echo -n %(commit) | xclip -selection c"
[alias] gitk-bg = !"gitk HEAD --not $(git rev-parse --remotes) &" publish = !"for i in origin public; do git push $i; done" [tig "bind"] generic = V @git gitk-bg generic = > !git publish
Internal user-defined commands
Actions beginning with a : will be run and interpreted as internal commands and act similar to commands run via Tig’s prompt. Valid internal commands are configuration file options (as described in this document) and pager view commands. Examples:# Reload ~/.tigrc when 'S' is pressed bind generic S :source .tigrc # Change diff view to show all commit changes regardless of file limitations bind diff F :set diff-options = --full-diff # Show the output of git-reflog(1) in the pager view bind generic W :!git reflog # Search for previous diff (c)hunk and next diff header bind stage 2 :?^@@ bind stage D :/^diff --(git|cc) bind main I :toggle id # Show/hide the ID column bind diff D :toggle diff-options --minimal # Use minimal diff algorithm bind diff [ :toggle diff-context -3 # Decrease context (-U arg) bind diff ] :toggle diff-context +3 # Increase context bind generic V :toggle split-view-height -10% # Decrease split height
Action names
Valid action names are described below. Note, all action names are case-insensitive, and you may use -, _, and . interchangeably, e.g. "view-main", "View.Main", and "VIEW_MAIN" are the same.view-main | Show main view |
view-diff | Show diff view |
view-log | Show log view |
view-reflog | Show reflog view |
view-tree | Show tree view |
view-blob | Show blob view |
view-blame | Show blame view |
view-refs | Show refs view |
view-status | Show status view |
view-stage | Show stage view |
view-stash | Show stash view |
view-grep | Show grep view |
view-pager | Show pager view |
view-help | Show help view |
enter | Enter and open selected line |
back | Go back to the previous view state |
next | Move to next |
previous | Move to previous |
parent | Move to parent |
view-next | Move focus to the next view |
refresh | Reload and refresh view |
maximize | Maximize the current view |
view-close | Close the current view |
view-close-no-quit | Close the current view without quitting |
quit | Close all views and quit |
status-update | Stage/unstage chunk or file changes |
status-revert | Revert chunk or file changes |
status-merge | Merge file using external tool |
stage-update-line | Stage/unstage single line |
stage-update-part | Stage/unstage part of a chunk |
stage-split-chunk | Split current diff chunk |
move-up | Move cursor one line up |
move-down | Move cursor one line down |
move-page-up | Move cursor one page up |
move-page-down | Move cursor one page down |
move-half-page-up | Move cursor half a page up |
move-half-page-down | Move cursor half a page down |
move-first-line | Move cursor to first line |
move-last-line | Move cursor to last line |
move-next-merge | Move cursor to next merge commit |
move-prev-merge | Move cursor to previous merge commit |
scroll-line-up | Scroll one line up |
scroll-line-down | Scroll one line down |
scroll-page-up | Scroll one page up |
scroll-page-down | Scroll one page down |
scroll-half-page-up | Scroll half a page up |
scroll-half-page-down | Scroll half a page down |
scroll-first-col | Scroll to the first line columns |
scroll-left | Scroll two columns left |
scroll-right | Scroll two columns right |
search | Search the view |
search-back | Search backwards in the view |
find-next | Find next search match |
find-prev | Find previous search match |
edit | Open in editor |
prompt | Open the prompt |
options | Open the options menu |
screen-redraw | Redraw the screen |
stop-loading | Stop all loading views |
show-version | Show version information |
none | Do nothing |
COLOR COMMAND
Color commands control highlighting and the user interface styles. If your terminal supports color, these commands can be used to assign foreground and background combinations to certain areas. Optionally, an attribute can be given as the last parameter. The syntax is:color area fgcolor bgcolor [attributes]
# Override the default terminal colors to white on black. color default white black # Diff colors color diff-header yellow default color diff-index blue default color diff-chunk magenta default color "Reported-by:" green default # View-specific color color tree.date black cyan bold
[tig "color"] # A strange looking cursor line cursor = red default underline # UI colors title-blur = white blue title-focus = white blue bold # View-specific color [tig "color.tree"] date = cyan default bold
Can be either a built-in area name or a custom
quoted string. The latter allows custom color rules to be added for lines
matching a quoted string. Valid built-in area names are described below. Note,
all names are case-insensitive, and you may use -, and _
interchangeably, e.g. "Diff-Header" and "DIFF_HEADER" are
the same. View-specific colors can be defined by prefixing the view name to
the area name, e.g. "stage.diff-chunk" and
"diff.diff-chunk".
Color names
Valid colors include: white,
black, green, magenta, blue, cyan,
yellow, red, default. Use default to refer to the
default terminal colors, for example, to keep the background transparent when
you are using a terminal with a transparent background.
Colors can also be specified using the keywords color0, color1,
..., colorN-1 (where N is the number of colors supported by your
terminal). This is useful when you remap the colors for your display or want
to enable colors supported by 88-color and 256-color terminals. Note that the
color prefix is optional. If you prefer, you can specify colors
directly by their numbers 0, 1, ..., N-1 instead, just
like in the configuration file of Git.
Attribute names
Valid attributes include: normal,
blink, bold, dim, reverse, standout, and
underline. Note, not all attributes may be supported by the
terminal.
UI colors
The colors and attributes to be used for the text that is not highlighted or that specify the use of the default terminal colors can be controlled by setting the default color option.default | Override default terminal colors (see above). |
cursor | The cursor line. |
status | The status window showing info messages. |
title-focus | The title window for the current view. |
title-blur | The title window of any backgrounded view. |
search-result | Highlighted search result. |
delimiter | Delimiter shown for truncated lines. |
header | The view header lines. Use status.header to color the staged, unstaged, and untracked sections in the status view. Use help.header to color the keymap sections in the help view. |
line-number | Line numbers. |
id | The commit ID. |
date | The author date. |
author | The commit author. |
mode | The file mode holding the permissions and type. |
overflow | Title text overflow. |
directory | The directory name. |
file | The file name. |
file-size | File size. |
graph-commit | The commit dot in the revision graph. |
palette-[0-13] | 14 different colors, used for distinguishing branches or commits. By default, the palette uses the ASCII colors, where the second half of them have the bold attribute enabled to give a brighter color. Example: palette-0 = red |
main-commit | The commit comment. |
main-annotated | The commit comment of an annotated commit. |
main-head | Label of the current branch. |
main-remote | Label of a remote. |
main-tracked | Label of the remote tracked by the current branch. |
main-tag | Label of a signed tag. |
main-local-tag | Label of a local tag. |
main-ref | Label of any other reference. |
main-replace | Label of replaced reference. |
stat-none | Empty status label. |
stat-staged | Status flag of staged files. |
stat-unstaged | Status flag of unstaged files. |
stat-untracked | Status flag of untracked files. |
help-group | Help group name. |
help-action | Help action name. |
Highlighting
Diff markupOptions concerning diff start, chunks and
lines added and deleted.
Extra diff information emitted by the Git diff
machinery, such as mode changes, rename detection, and similarity.
Commit diffs and the revision logs are usually
formatted using pretty printed headers , unless --pretty=raw was given. This
includes lines, such as merge info, commit ID, and author and committer
date.
Usually shown when --pretty=raw is given,
however commit is pretty much omnipresent.
Most common trailer lines (e.g. Signed-off-by)
are colorized. Characters in the commit title exceeding a predefined width can
be highlighted.
Tree markup
Colors for information of the tree view.
SOURCE COMMAND
Source commands make it possible to read additional configuration files. Sourced files are included in-place, meaning when a source command is encountered the file will be immediately read. Any commands later in the current configuration file will take precedence.source [-q] path
source ~/.tig/colorscheme.tigrc source ~/.tig/keybindings.tigrc
COPYRIGHT
Copyright (c) 2006-2014 Jonas Fonseca < [email protected][1]>SEE ALSO
tig(1), tigmanual(7), git(7), git-config(1)NOTES
mailto:[email protected]
02/26/2022 | Tig 2.5.5 |