Skip to content

lazygit

Justin Puah edited this page Jul 13, 2026 · 1 revision

lazygit config with delta pager, nvim editor, and Catppuccin theme switching.

Files

File Purpose
config.yml Base config — delta pager, nvim editor, nerd fonts
theme-mocha.yml Catppuccin Mocha (dark)
theme-latte.yml Catppuccin Latte (light)

Theme switching

On Windows, the PowerShell profile reads AppsUseLightTheme from the registry at startup and sets LG_CONFIG_FILE to config.yml,theme-mocha.yml or config.yml,theme-latte.yml. lazygit merges them in order, so the theme overrides only the gui.theme keys. No manual selection needed — it follows the OS dark/light setting, the same as fzf and nvim.

On Linux, setup.sh symlinks config.yml only. Theme switching is not wired to the bash profile.

Install

Windows

No files are copied. LG_CONFIG_FILE is set in the PowerShell profile and points directly at the repo. Run setup.ps1 -Module lazygit to verify lazygit is installed.

.\setup.ps1 -Module lazygit

Linux / WSL

./setup.sh -m lazygit

Symlinks ~/.config/lazygit/config.ymllazygit/config.yml.

Prerequisites

Tool Install
lazygit winget install JesseDuffield.lazygit
delta winget install dandavison.delta
Neovim winget install Neovim.Neovim

Source: lazygit/README.md in the dotfiles repo.

dotfiles wiki

Getting started

Core (Windows)

Cross-platform

Claude Code & AI

Reference

Legacy (Linux)

Troubleshooting

Clone this wiki locally