A GitHub CLI extension that analyzes user activity and generates statistics and visualizations for any timeframe.
- Activity Tracking — Commits, pull requests, issues, reviews, releases, and more
- Statistics — Streaks, event distributions, top repositories, activity patterns
- Multiple Formats — Text, JSON, Markdown, and interactive HTML reports with Plotly charts
- Flexible Date Ranges — Query any timeframe with year, month, and custom date range options
gh extension install ivuorinen/gh-historyOr build from source:
git clone https://github.com/ivuorinen/gh-history.git
cd gh-history
make build# Defaults to the authenticated user if no username is given
gh history [username] [options]gh history --year 2025
gh history --last-month
gh history --last-90-days
gh history --from 2024-01-01 --to 2024-12-31gh history octocat --format text
gh history octocat --format json
gh history octocat --format markdown # default
gh history octocat --format html # generates and opens an interactive report
gh history octocat --format json -o stats.jsongh history octocat --verbose # show progress and debug info
gh history --version # show versiongh-history uses your existing GitHub CLI authentication. No separate setup is needed.
gh auth loginToken resolution order: GH_TOKEN env var, GITHUB_TOKEN env var, gh auth config.
make build # Build for current platform
make test # Run tests
make lint # Run go vet + staticcheck
make test-race # Run tests with race detector
make test-cov # Run tests with coverage
make build-all # Cross-compile for all platforms
make clean # Remove build artifactsReleases use CalVer tags and are built automatically by GitHub Actions with GoReleaser. Binaries are signed with cosign.
make release # Tag and push a new CalVer release (requires clean main branch)make all # Runs lint, test, and buildMIT