gitplot

Git history visualizations from the command line.

Quick Start

uvx gitplot sediment https://github.com/pola-rs/polars
uvx gitplot sediment /path/to/local/repo --samples 50 --workers 2

Charts

sediment

Stacked area chart showing code age layers over time. Each color band represents lines of code from a specific time period, revealing how quickly code gets replaced.

Based on gitcharts by Vincent D. Warmerdam.

gitplot sediment repo                              # default: quarter granularity, 100 samples, PNG
gitplot sediment repo --granularity year            # group by year instead of quarter
gitplot sediment repo --since 2023-01-01            # only show recent history
gitplot sediment repo --format svg                  # SVG output
gitplot sediment repo --samples 200                 # more data points (incremental)
gitplot sediment repo --include '\.py$'             # only Python files
gitplot sediment repo --exclude 'tests/|lock'       # drop tests and lockfiles
open $(gitplot sediment repo --quiet)               # open the chart directly

--include/--exclude are regexes matched against each file's path; they also work on survivors and busfactor. By default every tracked file is analyzed.

Raw blame data is stored as parquet for incremental reuse. Re-running with more samples only computes the delta. Changing visual settings (granularity, since, format) is instant; changing --include/--exclude re-collects, since they determine which files get blamed.

Development

uv sync
make check
make test