gh-repo-growth

Visualize the growth of GitHub repositories over time as a self-contained HTML chart.

Usage

bunx gh-repo-growth

This fetches your repositories via the GitHub GraphQL API and outputs repo_growth.html.

Options

-u, --user <username>    GitHub username (default: authenticated user)
-o, --output <file>      Output HTML file (default: repo_growth.html)
    --include-forks      Include forked repositories
    --exclude-private    Exclude private repositories
    --exclude-archived   Exclude archived repositories
-h, --help               Show this help message

Examples

# Visualize your own repos
bunx gh-repo-growth

# Visualize another user's public repos
bunx gh-repo-growth -u octocat

# Custom output path with filters
bunx gh-repo-growth -o growth.html --exclude-archived

Example

Prerequisites

• GitHub CLI (gh) installed and authenticated (gh auth login)

The tool reads your GitHub token from gh auth token. No additional authentication setup is needed.

Output

The generated HTML file is fully self-contained (only external dependency is Chart.js via CDN) and includes:

• Cumulative repository count line chart
• Monthly creation bar chart
• Yearly summary table
• Stats cards (total repos, most active month, first repo date, time span)

Development

# Install dependencies
bun install

# Type check
bun run typecheck

# Build
bun run build

# Run locally
bun run src/index.ts

License

MIT