Skip to content

Configuration Overview

LazyWorktree supports layered configuration from defaults up to CLI overrides.

Use this page when: you need to understand where settings come from and how to apply them safely.

Configuration Sources

Highest to lowest precedence:

  1. CLI --config overrides
  2. Git local configuration (git config --local)
  3. Git global configuration (git config --global)
  4. YAML file (~/.config/lazyworktree/config.yaml)
  5. built-in defaults

Global YAML

Primary config file:

  • ~/.config/lazyworktree/config.yaml

Reference example:

Git Configuration Prefix

Use lw. keys:

git config --global lw.theme nord
git config --local lw.sort_mode switched

List configured keys:

git config --global --get-regexp "^lw\."
git config --local --get-regexp "^lw\."

Configuration Areas