GH Profile CLI 🔍

A beautiful command-line tool to analyze GitHub profiles and repositories.

Features

• 📊 Profile Overview — Display user info, stats, and account age
• ⭐ Top Repositories — View most-starred repos with details
• 🗣️ Language Breakdown — Analyze code languages across repos
• 📝 Export — Save analysis as Markdown

Installation

# Clone and install
git clone https://github.com/antorm1/gh-profile-cli.git
cd gh-profile-cli
pip install -e .

# Or install dependencies only
pip install -r requirements.txt

Usage

# Analyze any GitHub profile
gh-profile antorm1

# Show top 10 repos
gh-profile antorm1 --top 10

# Include language breakdown
gh-profile antorm1 --langs

# Export results to markdown
gh-profile antorm1 --langs --export report.md

# Combine options
gh-profile octocat --top 3 --langs --export octocat.md

Output Preview

The tool displays:

• Profile card with bio, location, and stats
• Top repositories table with stars, forks, and languages
• Language breakdown with byte counts and percentages
• Overall summary with account age

Requirements

• Python 3.8+
• requests — HTTP requests
• rich — Beautiful terminal output
• click — CLI framework

Project Structure

gh-profile-cli/
├── gh_profile/
│   ├── __init__.py      # Package metadata
│   └── main.py          # CLI entry point
├── pyproject.toml        # Build configuration
├── requirements.txt      # Dependencies
└── README.md            # This file

License

MIT License — see LICENSE for details.