lazygit
Manage Git repositories within a terminal UI
TLDR
Open Lazygit in the current repository
Open Lazygit for a specific Git repository
Start Lazygit with focus on a specific panel
Print the default Lazygit configuration
Tail the Lazygit logs (useful with debug mode in another terminal)
Run Lazygit in debug mode
Print the configuration directory
SYNOPSIS
lazygit [options] [<path>]
PARAMETERS
-d, --debug
Enable debug logging to stderr
--git-dir=<path>
Use Git directory at <path>
--worktree=<path>
Use worktree at <path>
-p, --path=<path>
Show given <path> in file view on startup
--use-config-dir=<path>
Use config directory at <path>
-V, --version
Display version information
-h, --help
Show help message
DESCRIPTION
Lazygit is a simple, fast, and intuitive terminal-based user interface for Git, built in Go with a curses frontend. It provides a graphical overview of your Git repository, allowing users to stage, commit, push, pull, rebase, and perform other Git operations without leaving the terminal.
Key features include:
• Visual branching and commit graphs
• Diff previews and hunk staging
• Submodule support
• Customizable keybindings (Vim and Emacs presets)
• Mouse support for easier navigation
Designed for developers who prefer keyboard-driven workflows, lazygit abstracts complex Git commands into mouse-friendly or key-shortcut actions, reducing errors and speeding up version control tasks. It's lightweight, asynchronous, and works on Linux, macOS, and Windows.
CAVEATS
Requires Git 2.24+ installed. Best with terminals supporting true color and mouse (e.g., kitty, Alacritty). Config at $XDG_CONFIG_HOME/lazygit/config.yml.
INSTALLATION
Via package managers: apt install lazygit (Ubuntu/Debian), brew install lazygit (macOS), or binaries from GitHub releases.
KEYBINDINGS
Vim-style by default (hjkl navigation, space to check/uncheck). Customize in config.yml. ? for help pane.
HISTORY
Created by Jesse Chancellor in 2017 as a Go rewrite of a previous project. Gained popularity via GitHub (jesseduffield/lazygit), with regular releases adding features like bisect support and filtering. Actively maintained with 50k+ stars.
SEE ALSO
git(1)


