SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsgithub

github

Testing & quality

View repository

Updated 10-15 20:09

About this skill

GitHub Integration

Connection

  • Base URL: https://api.github.com (REST v3), https://api.github.com/graphql (GraphQL v4)
  • Auth: Authorization: Bearer $GITHUB_TOKEN (personal access token)
  • Env vars: GITHUB_TOKEN
  • Caching: 5-minute in-memory cache, max 200 entries

Server Lib & API Routes

  • Server lib: server/lib/github.ts
  • Route handler: server/routes/github.ts

Exported Functions

Function Description
searchPRs(opts) Search PRs using GitHub search syntax
searchIssues(opts) Search issues using GitHub search syntax
getPR(owner, repo, number) Full PR detail — commits, reviews, files (4 parallel API calls)
getIssue(owner, repo, number) Issue detail with labels, assignees
listPRs(owner, repo, opts) List repo PRs by state (open/closed/all)
searchOrgPRs(opts) Convenience wrapper — prepends the org:<org> is:pr qualifiers
runGraphQL(query, variables?) Raw GraphQL query

API Routes

Route Description
GET /api/github/search?q=...&type=pr|issue&limit=30 Full GitHub search syntax
GET /api/github/pr?owner=...&repo=...&number=... PR detail with commits, reviews, files
GET /api/github/issue?owner=...&repo=...&number=... Issue detail
GET /api/github/prs?owner=...&repo=...&state=open|closed|all List repo PRs
GET /api/github/org-prs?org=<org>&q=...&state=OPEN|CLOSED|MERGED Org-wide PR search
POST /api/github/graphql body: { query, variables? } Raw GraphQL

Script Usage

# Search open PRs in an org
pnpm action github-prs --org=<org> --query="is:open label:bug"

# List PRs for a specific repo
pnpm action github-prs --repo=<org>/<repo> --state=open

# Get full PR detail (commits, reviews, files)
pnpm action github-prs --pr=<org>/<repo>/1234

# Get issue detail
pnpm action github-prs --issue=<org>/<repo>/567

# Full GitHub search syntax (works across all orgs/repos)
pnpm action github-prs --search="fix authentication is:pr is:merged"
pnpm action github-prs --search="memory leak" --type=issue

# Raw GraphQL
pnpm action github-prs --graphql='{ viewer { login } }'

# Filtering with built-in helpers
pnpm action github-prs --org=<org> --grep="auth" --fields=number,title,state,url

Key Patterns & Gotchas

GitHub search qualifiers (useful for --search and --query)

  • org:<org> — all repos in org
  • repo:<org>/<repo> — specific repo
  • is:pr is:open / is:pr is:merged / is:pr is:closed
  • is:issue is:open / is:issue is:closed
  • author:username — PRs/issues by author
  • assignee:username — assigned to user
  • label:bug — by label
  • in:title keyword — keyword in title
  • created:>2025-01-01 — date range
  • review:approved — approved PRs
  • review:changes_requested

Implementation Notes

  • searchOrgPRs() is a convenience wrapper that prepends org:<org> is:pr — use searchPRs() / searchIssues() directly for full control
  • The REST search API returns up to 100 results per call; paginated list endpoints use restGetPaginated() with Link header traversal
  • getPR() makes 4 parallel API calls: PR data, commits, reviews, files — provides a complete picture in one shot
  • 5-minute in-memory cache on all requests