Hindsight

Hindsight is a GitHub-style git activity visualizer for your terminal. It scans your local directories for git repositories and aggregates your contribution history into a beautiful, blue, pixel-perfect heatmap.

Installation

cargo install hindsight

You can get cargo here.

Usage

hindsight [OPTIONS] [PATH]

Interactive TUI (Default)

Run without arguments to scan the current directory and open the TUI:

hindsight

Arguments

• [PATH]: directory to scan (default: current dir)

Options

Flag	Description
--days <N>	Number of days to look back (default: 365)
--depth <N>	Max recursion depth for finding repos (default: 3)
--authors "<NAMES>"	Filter by comma-separated author list
--list	Print detailed stats table to stdout
--export-tsv <FILE>	Export stats to TSV file

Examples

Analyze a specific workspace for the last 30 days:

hindsight --days 30 ~/Dev

Filter for your own commits:

hindsight --authors "Alice,Alice Smith"

Export your yearly stats to a file:

hindsight --export-tsv 2024_stats.tsv

License

MIT