Skip to content

CLI tool to fetch and beautifully format all your GitHub contributions to any organization!

Notifications You must be signed in to change notification settings

Siddhant-K-code/github-contribution-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

๐Ÿš€ GitHub Contribution Tracker

A powerful CLI tool to fetch and beautifully format all your GitHub contributions to any organization!

โœจ Features

  • ๐Ÿ“Š Comprehensive contribution tracking
    • Pull Requests (open, closed, merged)
    • Issues
    • Commits
  • ๐Ÿ“ Beautiful Markdown export
  • ๐Ÿ“… Chronological sorting
  • ๐Ÿ” Detailed statistics
  • ๐ŸŽฏ Organization-specific insights

๐Ÿ› ๏ธ Installation

  1. Clone this repository:
git clone https://github.com/Siddhant-K-code/github-contribution-tracker
cd github-contribution-tracker
  1. Install dependencies:
pip install requests
  1. Set up your GitHub token:
export GITHUB_TOKEN=your_github_personal_access_token

๐ŸŽฎ Usage

Run the tracker with:

python main.py USERNAME ORGANIZATION_NAME

Example:

python main.py Siddhant-K-code OpenFGA

๐Ÿ“ฆ Output

The tool generates a beautifully formatted contributions.md file containing:

๐Ÿ“Š Summary Section

  • Total Pull Requests
  • Total Issues
  • Total Commits

๐Ÿ“ Detailed Sections

  • Pull Requests: Title, status, and date
  • Issues: Title, status, and date
  • Commits: Message and date

๐Ÿ”‘ GitHub Token Permissions

Your token needs these scopes:

  • repo
  • read:org
  • read:user

๐Ÿ’ก Example Output

# GitHub Contributions for Siddhant-K-code in OpenFGA

## Summary
- Total Pull Requests: 42
- Total Issues: 15
- Total Commits: 123

## Detailed Contributions
[...]

๐Ÿ› ๏ธ Technical Details

  • Uses GitHub's GraphQL API
  • Implements pagination for complete data retrieval
  • Sorts contributions chronologically
  • Handles rate limiting gracefully

About

CLI tool to fetch and beautifully format all your GitHub contributions to any organization!

Topics

Resources

Stars

Watchers

Forks

Languages