CommitLens

A universal Git contribution analyzer that tracks commits, additions, and deletions per contributor. It features a powerful local Git engine, a terminal TUI, and a modern Web UI embedded in a single binary.

Key Features

• Universal Git Engine: Supports both local filesystem repositories and remote GitHub URLs (via automatic bare clones). No GitHub API rate limits for history analysis.
• Advanced Filtering: Multi-select support for repositories and contributors. Drill down by week, month, quarter, or year.
• Contribution Trends:
  • Commit Volume: Visualize submission frequency over time.
  • Code Lines: Track code churn with stacked addition/deletion trends (New!).
  • Period Comparisons: Compare each period with the immediately previous period and up to three matching historical periods.
• GitHub Organization Contributions: View yearly commits, pull requests, issues, reviews, and contribution calendars, then download the combined chart as PNG.
• Interactive TUI: A fast, keyboard-driven terminal interface powered by bubbletea.
• Modern Web UI: A searchable, scrollable React interface with high-density ECharts visualizations.
• Deduplicated Co-authorship: Correctly credits all participants in a commit (via Co-authored-by trailers).
• Embedded Binary: The entire frontend is compiled into the Go binary. Just one file to run.
• CI/CD Ready: Integrated with GitHub Actions and GoReleaser for automated cross-platform builds.

Screenshots

Terminal UI (TUI)

Commit Trend	Commit History

Web UI

Dashboard (Commits)	Lines Trend	Commit History

Quick Start

Installation

Download the latest binary from Releases.

Configuration

Create a config.yaml:

discoveryRoots:
- ~/src/github.com/kubernetes # Automatically scan all git repos in this folderrepositories:
- owner: example-org # Web: discover repositories, then select which ones to sync
- owner: example-orgrepo: example-repo # Exact remote repository; synced by defaultuserMap:
"Jim Yang": ["jimyag", "yang.jim@example.com"] # Map aliases to a single personreporting:
timezone: Local # Or an IANA zone such as Asia/Taipei

An owner-only repository entry is a Web discovery source. CommitLens lists the repositories accessible to the configured GitHub token, but does not automatically synchronize the whole organization. Select repositories from the Web repository dropdown, then click Refresh. Exact owner + repo entries and discovered local repositories keep their existing default-sync behavior.

The GitHub organization contribution view uses the GraphQL API. Grant the token read:user to include private contributions; years with no contributions are omitted.

Commit and line trend pages in both Web and TUI include a comparison chart. Weekly comparisons use the same week position in earlier months; monthly and quarterly comparisons use the same period in earlier years. An in-progress period is compared at the same elapsed point.

Usage

# Run the Terminal UI
./commitlens --config config.yaml
# Run the Web UI (default: http://localhost:8080)
./commitlens --web --config config.yaml

Shortcuts (TUI)

• 1-5: Switch tabs (Summary, Repos, Commit Trend, Lines Trend, Commits).
• [ / ]: Cycle tabs.
• Tab: Cycle focus between filters and content.
• Enter: Expand filter dropdown / View commit details.
• Space: Multi-select items in dropdowns.
• Shift + ←/→: Scroll charts horizontally.
• R: Force sync/refresh data.
• Q: Quit.

Mouse controls:

• Click tabs, filters, dropdown options, repository rows, and commit rows.
• Use the wheel to scroll dropdowns and lists, or pan trend charts horizontally.
• Click a period in a trend chart to open its commit list.

Development

Requirements

• Go 1.22+
• nvm
• Task

Build from source

task build

License

MIT