Tig

tig

An ncurses-based text-mode interface for git, functioning mainly as a repository browser but also able to stage changes and act as a pager.

Runs as tig|macOS, Linux, Windows|jonas.github.io

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Tig in your home directory Every rule on this page, by file

· ~/.tigrc Sync

· ~/.config/tig/config Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/tig/otty.tomlThe file this page is generated from

id = "tig"

name = "Tig"

homepage = "https://jonas.github.io/tig/"

description = "An ncurses-based text-mode interface for git, functioning mainly as a repository browser but also able to stage changes and act as a pager."

executables = ["tig"]

[dotfiles]

# tigrc(5): "You can permanently set an option by putting it in the `~/.tigrc`

# file" and "In some environments, a user's configuration will be stored in the

# alternate location `$XDG_CONFIG_HOME/tig/config`." The manual repeats it

# under Configuration Files: Tig "proceeds to read the user's configuration

# file (`~/.tigrc` or `$XDG_CONFIG_HOME/tig/config` by default)", overridable

# with $TIGRC_USER.

# The second one is the XDG variable itself, not the `~/.config` default, so it

# is written as [configHome] — which is `~/.config` on macOS too, matching what

# Tig looks for there.

paths = [

"~/.tigrc",

"[configHome]/tig/config",

]

# The manual's History Files section puts the readline history at

# `~/.tig_history` or `$XDG_DATA_HOME/tig/history` — a different directory from

# either path above, so there is nothing to carve out of what is listed.

exclude = []

# A tigrc is `set`, `bind`, `color` and `source` commands. Nothing in it is a

# credential; Tig reads no passwords of its own and defers to Git for remotes.

secret = []

# No machine_lines: the file is key bindings, colour definitions and display

# options, which are the reason to carry it. The one line-oriented thing that

# could be machine-local is `source <path>`, but Tig's own documentation shows

# it used for relative, repository-tracked files as often as absolute ones, so

# naming it would hold back more than it should.

# tig parses its configuration at startup and exits with the pager; nothing

# holds the file open between runs.

side_effect = false

[commands]

format = 1

label = "Open Tig"

description = "Open the text-mode Git browser in a chosen view, optionally in another repository. Revision ranges and paths are left out."

quality = "ai-draft"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "man"

kind = "manual"

url = "https://github.com/jonas/tig/blob/master/doc/tig.1.adoc"

revision = "master 2026-10"

evidence = """

tig [options] [revisions] [--] [paths]

tig log [options] [revisions] [--] [paths]

tig show [options] [revisions] [--] [paths]

tig reflog [options] [revisions]

tig blame [options] [rev] [--] path

tig grep [options] [pattern]

tig refs [options]

tig stash [options]

tig status

-C <path>::

"""

[[commands.field]]

id = "view"

label = "View"

description = "Leave empty for the default main view."

type = "enum"

position = 0

choices = [{ value = "log", label = "Log" }, { value = "show", label = "Show" }, { value = "reflog", label = "Reflog" }, { value = "blame", label = "Blame" }, { value = "grep", label = "Grep" }, { value = "refs", label = "Refs" }, { value = "stash", label = "Stash" }, { value = "status", label = "Status" }]

sources = ["man"]

[[commands.field]]

id = "dir"

label = "Run in directory"

type = "path"

path = { kind = "directory", role = "input" }

option = ["-C"]

sources = ["man"]

[[commands.task]]

id = "status"

label = "Open status view"

fields = ["view", "dir"]

required = ["view"]

set = { view = ["status"] }

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["view", "dir"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/tig. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.