git-charts

Interactive terminal chart for visualizing how a git repository grows over time.

Status: Maintained Bun CLI. The source checkout is 0.1.1; npm currently serves the verified 0.1.0 release.

git-charts reads first-parent history, computes cumulative LOC snapshots, picks a fitting default resolution, and renders an interactive terminal chart. The default view is a line chart.

Install

Local:

bun install
bun run index.ts ../your-repo

From npm:

bunx git-charts ../your-repo

Usage

git-charts [repo-path] [day|week|month|quarter|year]

Examples:

bun run index.ts
bun run index.ts ../gastown
bun run index.ts ../gastown day

If you omit the period, git-charts automatically chooses the finest resolution that fits the current terminal width.

Controls

• left / right or h / l: move selection
• g / G: jump to start or end
• d / w / m / p / y: switch period
• v: toggle line or bar chart
• q: quit

Notes

• Uses git log --first-parent so the chart follows the main branch timeline.
• Values are total LOC snapshots, not per-period deltas.
• History is cached inside the repo’s .git directory for faster repeat runs.

Publish

See PUBLISHING.md.

Launch

See LAUNCH.md.

Test

bun install --frozen-lockfile
bun test
bun run index.ts --help