GitHub Contributions

A tool to fetch and analyze your GitHub contributions across all repositories. Get insights on your stars, pull requests, and contribution history.

Features

📊 Fetch all your GitHub repositories and contribution stats
⭐ Sort by stars, PR count, or combined score
🔍 Filter by owned vs external repos
🌐 Web interface with HTML and JSON API
🚀 CLI tool for quick analysis
📈 See your total stars and PR contributions

Getting Started

Prerequisites

Bun (or Node.js)
GitHub personal access token

Installation

git clone https://github.com/pablopunk/github-contributions.git
cd github-contributions
bun install

Configuration

Create a .env file with your GitHub token:

GITHUB_TOKEN=your_github_token_here

Get a personal access token from GitHub Settings.

Usage

CLI

# External repos, sorted by stars (default)
bun run cli

# Your own repos only
bun run cli -o

# All repos (owned + external contributions)
bun run cli -a

# Sort by PR contributions
bun run cli --sort contributions

# Top 10 by combined score
bun run cli --sort all -l 10

# Most recent contributions
bun run cli --sort recent

# Include private repos
bun run cli --private

# Exclude specific repos
bun run cli -x owner/repo1,owner/repo2

# Show help
bun run cli --help

Web Server

bun run server

Then visit http://localhost:3000 in your browser.

API Endpoints

GET / - HTML view with repository table
GET /api - JSON API response
GET /help - Command help

Query Parameters

# All parameters work on both / and /api endpoints

# Scope
?scope=own       # Only your own repos
?scope=external  # Only external repos (default)
?scope=all       # All repos (own + external)

# Sorting
?sort=stars           # Sort by stars (default)
?sort=contributions   # Sort by PR count
?sort=all             # Sort by combined score
?sort=recent          # Sort by most recent contribution

# Filtering
?limit=10                              # Limit to 10 results
?exclude=owner/repo1,owner/repo2       # Exclude specific repos
?include=owner/repo1,owner/repo2       # Always include these repos
?private=true                          # Include private repos

# Examples
http://localhost:3000/?scope=all&limit=10
http://localhost:3000/api?scope=own
http://localhost:3000/?sort=recent
http://localhost:3000/?private=true
http://localhost:3000/?exclude=pablopunk/github-contributions

Deployment

This project is ready to deploy on Vercel. The repository includes:

✅ vercel.json configuration with Bun support
✅ Environment variable setup for GITHUB_TOKEN
✅ Compatible build system

Deploy Now

Click the button at the top of this README or visit:

https://vercel.com/new/clone?repository-url=https://github.com/pablopunk/github-contributions&project-name=github-contributions&env=GITHUB_TOKEN

Manual Deployment

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

# Set environment variable when prompted
GITHUB_TOKEN=your_token_here

Development

Type Checking

bun run typecheck

Scripts

bun run cli - Run CLI tool
bun run server - Start web server
bun run typecheck - Check TypeScript

Technology Stack

Runtime: Bun
Language: TypeScript
Web Framework: Hono
Deployment: Vercel

License

MIT

Author

Pablo Punk

pablopunk/github-contributions