Configuration

Configuration is read from ~/.config/g/config.toml. It is created with defaults on first use.

Inspect and edit

g config              # summary + key paths
g config log_limit    # fuzzy search for a key (example)
g config --path       # print config file path only
g config --edit       # open in $EDITOR (default: vim if unset)
g config --themes     # interactive theme picker (remembers your choice)

Full example

[general]
default_branch = "main"
auto_fetch = false
# pager = "less"
# git_path = "/usr/bin/git"

[ui]
colors = true
icons = true
date_format = "relative"   # relative | short | iso | rfc
log_limit = 30
show_graph = true
theme = "dark"             # built-in name, custom name, or path — see Theming
# Borders and spacing come from the theme. Uncomment to override every theme:
# border_style = "sharp"   # sharp | rounded | heavy | double | ascii
# density = "normal"       # normal | compact | relaxed

[commit]
types = ["feat", "fix", "docs", "refactor", "perf", "test", "build", "ci", "chore", "revert"]
require_scope = false
require_body = false
max_subject_length = 72
gpg_sign = false

[diff]
tool = "auto"

[github]
# token = "…"              # prefer GITHUB_TOKEN in the environment
default_reviewers = ["alice"]
default_labels = ["needs-review"]

[workspace]
separator = "--"

[aliases]
co = "checkout"
br = "branch"
st = "status"
lg = "log"

[plugins]
discover = true
paths = []

Section reference

[general]

Key	Meaning
default_branch	Used when comparing or inferring base branch
auto_fetch	Optional automatic fetch behavior (if implemented for a command)
git_path	Override path to git binary
pager	Pager for long output

[ui]

Controls enhanced log, status, branch, etc. The theme key drives the full visual style — colors, icons, borders and spacing all come from the selected theme. border_style and density are optional overrides that force those dimensions regardless of theme. See Theming for the built-in themes and how to build and load your own.

[commit]

Drives g commit interactive flow: allowed types, subject length, GPG.

[diff]

tool selects the diff mode:

• "auto" / "builtin" (default) — builtin renderer (TUI if TTY, inline ANSI otherwise)
• "raw" — forward git diff output untouched
• any other string — path to an external executable; git diff stdout is piped through it generically (falls back to builtin if the binary isn’t found)

[github]

Defaults for g stack pr (labels, reviewers). Token: use GITHUB_TOKEN when possible.

[workspace]

separator is inserted between repo folder name and workspace name for default paths.

[aliases]

Shorthand before passthrough:

g co main        # expands then runs through git
g st -sb

[plugins]

Discover g-* executables on PATH, or list explicit binary paths.

Environment variables

Variable	Role
GITHUB_TOKEN	GitHub API for g stack pr
EDITOR	g config --edit
NO_COLOR	Disable ANSI color

CLI overrides

Override any supported key for one invocation:

g -c ui.log_limit=100 log
g -c diff.tool=/path/to/your-pager diff   # external pager (any executable on $PATH)

Related docs

• Log & diff — what [ui] and [diff] affect
• Workspaces — [workspace]
• Stacks — [github]