Skip to main content

​
Overview

Lazygit is a simple terminal UI for Git commands. The configuration includes custom Catppuccin-inspired theming and keybindings.

​
Installation

​
Arch Linux

yay -S lazygit

​
Ubuntu/Debian

Lazygit may need manual installation from the official releases: 
# Check https://github.com/jesseduffield/lazygit for latest release

​
Using Cargo

cargo install lazygit

​
Configuration

Lazygit configuration is stored in .config/lazygit/ with two main files:
  • config.yml - Keybindings and behavior settings
  • theme.yml - Color scheme configuration

​
Theme customization

The theme uses Catppuccin-inspired colors:
theme.yml
theme:
  activeBorderColor:
    - '#f38ba8'
    - bold
  inactiveBorderColor:
    - '#a6adc8'
  optionsTextColor:
    - '#89b4fa'
  selectedLineBgColor:
    - '#313244'
  cherryPickedCommitBgColor:
    - '#45475a'
  cherryPickedCommitFgColor:
    - '#f38ba8'
  unstagedChangesColor:
    - '#f38ba8'
  defaultFgColor:
    - '#cdd6f4'
  searchingActiveBorderColor:
    - '#f9e2af'

author Colors:
  '*': '#b4befe'

​
Color scheme

Active border

Pink (#f38ba8) with bold styling

Selection

Dark gray background (#313244)

Unstaged changes

Pink color (#f38ba8) for modified files

Search highlight

Yellow (#f9e2af) for active searches

​
Shell integration

Convenient alias for quick access:
.zshrc
alias lg="lazygit"

​
Usage

Launch Lazygit in any Git repository: 
lazygit  # Full command
lg       # Using alias

​
Key features

1

Stage and commit

Navigate files with arrow keys, press space to stage, c to commit
2

Branch management

Switch to branches view with [ and ] to navigate tabs
3

Visual diffs

View file changes with syntax highlighting and easy navigation
4

Interactive rebasing

Manage commit history with visual interactive rebase
Press ? inside Lazygit to see all available keybindings.

​
Integration with workflow

Lazygit integrates seamlessly with the development environment:
  • Works inside Tmux sessions
  • Can be launched from Neovim
  • Respects Git configuration and GPG signing
  • Follows the configured Git delta diff viewer
  • Neovim - Editor with Git integration
  • Git delta - Enhanced diff viewer (configured separately)

Build docs developers (and LLMs) love

Get started for freeTalk to us