github-repo

name	github-repo
description	Get GitHub repository information including stars, forks, issues, languages, and metadata. Use when the user asks for repository details, GitHub stats, or repo information.

Get GitHub Repository Information

Retrieve detailed information about a GitHub repository.

Usage

npx tsx scripts/repo.ts <repository> [options]

Arguments

Argument	Required	Description
repository	Yes	Repository in format owner/repo or full GitHub URL

Options

Option	Description
--token=TOKEN	GitHub Personal Access Token (optional, overrides GITHUB_TOKEN env var)
--no-cache	Bypass cache and fetch fresh data from API

Output

facebook/react
----------------
Description: A declarative, efficient, and flexible JavaScript library for building user interfaces.
Created: 2013-05-24
Updated: 2023-10-15
Pushed: 2023-10-15

Statistics:
  Stars: 213,456
  Forks: 45,678
  Open issues: 1,234
  Watchers: 7,890

Details:
  Language: TypeScript
  License: MIT
  Private: No
  Fork: No
  Default branch: main

Features:
  Issues: Enabled
  Projects: Enabled
  Wiki: Enabled
  Pages: Disabled

Script Execution (Preferred)

npx tsx scripts/repo.ts <repository> [options]

Options:

• --token=TOKEN - GitHub Personal Access Token (optional, overrides GITHUB_TOKEN env var)
• --no-cache - Bypass cache and fetch fresh data from API

Run from the github-api plugin directory: ~/.claude/plugins/cache/github-api/

Repository API

GET https://api.github.com/repos/{owner}/{repo}

Parameters

Parameter	Required	Description
owner	Yes	Repository owner (user or organization)
repo	Yes	Repository name

Examples

Get repository information:

https://api.github.com/repos/facebook/react

Response Format

The response contains comprehensive repository metadata:

• id - Repository ID
• name - Repository name
• full_name - Owner/repo (e.g., "facebook/react")
• owner - Owner object (login, id, avatar_url, type, etc.)
• description - Repository description
• private - Whether the repository is private
• fork - Whether this is a fork
• created_at - Creation timestamp
• updated_at - Last update timestamp
• pushed_at - Last push timestamp
• homepage - Homepage URL
• size - Repository size in kilobytes
• stargazers_count - Number of stars
• watchers_count - Number of watchers
• language - Primary programming language
• languages_url - URL to get all languages
• has_issues - Whether issues are enabled
• has_projects - Whether projects are enabled
• has_wiki - Whether wiki is enabled
• has_pages - Whether GitHub Pages is enabled
• forks_count - Number of forks
• open_issues_count - Number of open issues
• license - License information
• topics - Repository topics
• default_branch - Default branch name

URL Format Support

The script accepts various URL formats:

• owner/repo (simple format)
• https://github.com/owner/repo
• git+https://github.com/owner/repo
• [e-mail]:owner/repo
• ssh://[e-mail]/owner/repo

All formats are automatically parsed to extract owner and repo.

Authentication

GitHub API rate limits:

• Unauthenticated: 60 requests/hour
• Authenticated: 5,000 requests/hour

To increase your rate limit, provide a GitHub Personal Access Token:

Via environment variable:

export GITHUB_TOKEN=your_token_here
npx tsx scripts/repo.ts facebook/react

Via command-line option:

npx tsx scripts/repo.ts facebook/react --token=your_token_here

Create a token at: https://github.com/settings/tokens

Caching

Repository metadata is cached for 30 minutes. Repository information changes relatively infrequently, so this provides good freshness while improving performance.

Use the --no-cache flag to bypass the cache.

Related

• Use github-readme to fetch the repository README
• Use github-user to get owner profile information
• Use github-rate-limit to check your remaining API quota

Error Handling

Repository not found: Verify the owner and repository name are correct. Private repositories require authentication with appropriate access.

Rate limit exceeded: Use a Personal Access Token to increase your quota, or wait for the quota to reset (hourly).

Authentication errors: Ensure your token is valid and has the necessary permissions (for private repos).

Use Cases

Package Research

Get GitHub information for npm packages:

npx tsx scripts/repo.ts facebook/react
npx tsx scripts/repo.ts vercel/next.js

Repository Stats

Check popularity and activity:

npx tsx scripts/repo.ts nodejs/node --token=$GITHUB_TOKEN

License Information

Check repository license:

npx tsx scripts/repo.ts microsoft/typescript