git-bahn /git-graph
Command line tool to show clear git graphs arranged for your branching model
★ 1,004⑂ 58👁 8⑃ 86● 68▤ 23
+1
Daily
1,004
stars
58
forks
8
watchers
86
prs
68
issues
23
releases
README
git-graph A command line tool to visualize Git history graphs in a comprehensible way, following different branching models. The image below shows an example using the GitFlow branching model for a comparison between graphs generated by git-graph (far left) versus other tools and Git clients. GitFlow was chosen for its complexity, while any other branching model is supported, including user-defined ones. !Graph comparison between tools Decide for yourself which graph is the most comprehensible. :sunglasses: If you want an interactive Git terminal application, see git-igitt, which is based on git-graph. Features View structured graphs directly in the terminal Pre-defined and custom branching models and coloring Different styles, including ASCII-only (i.e. no "special characters") Custom commit formatting, like with git log --format="..." Installation Pre-compiled binaries 1. Download the latest binaries for your platform 2. Unzip somewhere 3. Optional: add directory git-graph to your PATH environmental variable Using cargo In case you have Rust installed, you can install with cargo: cargo install git-graph From homebrew If you use the homebrew package manager: brew install git-graph Usage For detailed information, see the manual. For basic usage, run the following command inside a Git repository's folder: git-graph Note: git-graph needs to be on the PATH, or you need use the full path to git-graph: C:/path/to/git-graph/git-graph Branching models Run git-graph with a specific model, e.g. simple: git-graph --model simple Alternatively, set the model for the current repository permanently: git-graph model simple Get help For the full CLI help describing all options, use: git-graph -h git-graph --help For styles and commit formatting, see the manual. Custom branching models Branching models are configured using the files in APP_DATA/git-graph/models. Windows: C:\Users\\AppData\Roaming\git-graph Linux: ~/.config/git-graph OSX: ~/Library/Application Support/git-graph File names of any .toml files in the models directory can be used in parameter --model, or via sub-command model. E.g., to use a branching model defined in my-model.toml, use: git-graph --model my-model For details on how to create your own branching models see the manual, section Custom branching models. Limitations Summaries of merge commits (i.e. 1st line of message) should not be modified! git-graph needs them to categorize merged branches. Supports only the primary remote repository origin. On Windows PowerShell, piping to file output does not work properly (changes encoding), so you may want to use the default Windows console instead Contributing Please report any issues and feature requests in the issue tracker. Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Top issues
#119No graph shown for small `-n` values4 comments · 2025-09-22#146Change default model to none3 comments · 2026-04-23#137add flag --first-parent only display first parent of merge commits3 comments · 2026-01-16#84Winget windows installer3 comments · 2024-07-04#154svg flag ignores format flag2 comments · 2026-10-08#90Add style with branch drawing symbols2 comments · 2024-11-21#74Support for macos-arm64 platforms2 comments · 2023-08-10#157More levels of configuration1 comments · 2026-10-14
Discussions
#130Increase contributions to the project27 comments · 2025-10-26#109Truncate fields in format1 comments · 2025-08-26#97I just wanted to ask if i can customize my keybindings for navigation1 comments · 2025-04-15#95Add Homebrew installation0 comments · 2025-03-12#82Graph for current branch1 comments · 2024-05-07#78How to get predictable and consistent coloring/positions for my branches.2 comments · 2024-02-09#66Does any other tool have the persistence / order feature?1 comments · 2023-03-15#132Is it possible to show username as well beside the commit?1 comments · 2023-02-01
Latest release
git-graph v0.8.3 v0.8.3 2026-10-29Fixed
- Breaking a pipe no longer cause panic.
Example:
git-graph | head -n 10