lazygit(1)
A simple terminal UI for git commands, providing an interactive interface for staging, committing, branching, and other git operations.
Synopsis
lazygit [FLAGS] [OPTIONS]Description
lazygit is a terminal-based Git client that brings a graphical interface to the command line. It simplifies common git workflows by allowing you to navigate repositories, stage files, create commits, manage branches, and resolve conflicts through keyboard shortcuts and mouse interactions instead of typing git commands.
The interface displays your repository status, recent commits, branches, and diffs in separate panels that you can navigate with arrow keys. It reduces cognitive load by visualizing git state and makes bulk operations like staging multiple files quick and intuitive.
Common options
| Flag | What it does |
|---|---|
-h, --help | Show help message and exit |
-v, --version | Display lazygit version number |
-c, --config-dir DIR | Set the config directory (default: platform-dependent, typically ~/.config/lazygit) |
-w, --work-tree DIR | Specify the working tree directory of your repository |
-g, --git-dir DIR | Specify the git directory (default: .git in the work tree) |
--use-config-file | Load config from a config file instead of using defaults |
-d, --debug | Enable debug logging to lazygit.log |
--log-level LEVEL | Set log verbosity (debug, info, warn, error) |
Examples
Launch lazygit in the current directory (assumes it's a git repository)
lazygitOpen lazygit for a specific project repository
cd ~/my-project && lazygitStart lazygit pointing to a specific work tree and git directory
lazygit -w /path/to/repo -g /path/to/repo/.gitUse a custom config directory instead of the default location
lazygit -c ~/.config/custom-lazygitRun lazygit with debug logging enabled (useful for troubleshooting)
lazygit --debugCapture debug output to a file for later inspection
lazygit --log-level debug > debug.log 2>&1Check which version of lazygit is installed
lazygit --version