---

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

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

Arguments

Options

Output

Copyfacebook/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)

Copynpx 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

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

Parameters

Examples

Get repository information:

Copyhttps://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
• git@github.com:owner/repo
• ssh://git@github.com/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:

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

Via command-line option:

Copynpx 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:

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

Repository Stats

Check popularity and activity:

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

License Information

Check repository license:

Copynpx tsx scripts/repo.ts microsoft/typescript