Skip to content

Display and Themes

Use these settings to control appearance, icon rendering, and layout behaviour.

Theme Selection

  • theme: explicit theme name
  • empty theme: auto-detect based on terminal background
  • CLI override: lazyworktree --theme <name>

Built-in themes and details:

Layout and Pane Arrangement

  • layout: default or top
  • runtime toggle: L

Layout controls how worktree, status, git status, commit, and notes panes are arranged.

Horizontal layout

The top layout, showing panes arranged horizontally.

Custom Pane Sizes

Use layout_sizes to adjust how much screen space each pane receives. Values are relative weights (1–100) that get normalised at computation time, so info: 30, git_status: 30, commit: 30 means each gets one-third of the secondary area.

layout_sizes:
  worktrees: 45    # Main pane width (default) or height (top layout)
  info: 30         # Info pane share of secondary area
  git_status: 30   # Git status pane share (when visible)
  commit: 30       # Commit log pane share
  notes: 30        # Notes pane share (when visible)

All fields are optional. Omitted fields keep their built-in defaults. Focus-based dynamic resizing still applies on top of the configured baseline.

Tip: On smaller terminals, setting worktrees to a higher value such as 80 gives the worktree list more room whilst keeping the info and commit panes visible. You can also resize the worktree pane at runtime with h (shrink) and l (grow).

Worktree pane at 80%

With worktrees: 80, the worktree list gets more space on a compact screen.

Icon Rendering

  • icon_set: nerd-font-v3 or text
  • avatar_badges: auto, never, or always

If glyphs render incorrectly, use text or install a patched Nerd Font.

When avatar_badges: auto is set, the Info pane shows small avatars for the PR/MR author and reviewers only when LazyWorktree detects a Kitty-compatible terminal such as Kitty, WezTerm, or Ghostty. Use never to keep plain text everywhere, or always to use the Kitty graphics path in a compatible terminal that LazyWorktree does not detect automatically.

Reviewers

  • pr_reviewers: auto or never

pr_reviewers: auto adds a reviewer line to the Info pane for the selected worktree, listing how many people have submitted a review and who they are. Bots are marked with a bot icon, and everyone else is shown with their avatar when avatar badges are available. Each name carries the outcome of its review: approved, changes requested, or simply commented. Set never to omit the line and the forge request that populates it.

Commit Log Indicators

The commit log pane uses theme colours for push and merge status:

  • ErrorFg (typically red) indicates unpushed commits (↑).
  • WarnFg (typically yellow) indicates unmerged commits (★), which have been pushed but are not in main.

These colours are defined in each theme and follow the selected theme automatically.

Name Truncation

  • max_name_length: max display width for worktree names
  • set to 0 to disable truncation