copilot-dev: Command for Claude Code

I want to help you find and use the right GitHub API endpoint for your goal.

Tell me what you're trying to accomplish

If you haven't already described your goal, please share it now. For example:

• "I want to list all open pull requests in a repository"
• "I want to create a GitHub Issue via the API"
• "I want to fetch all members of a GitHub organization"

---

What I'll provide

For your goal, I'll give you:

1. The recommended endpoint

I'll tell you whether to use the GitHub REST API or GitHub GraphQL API and explain why, then give you the full endpoint path.

REST API is best for:

• Simple CRUD operations on a single resource
• When you don't need fine-grained field selection
• Webhooks, Actions, and most automation tasks

GraphQL API is best for:

• Fetching related data in a single request (e.g., PR + reviews + comments)
• Reducing over-fetching when only a few fields are needed
• Complex queries across multiple resource types

2. Working curl examples

REST example (listing open pull requests):

# Using a Personal Access Token (classic)
curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  "https://api.github.com/repos/OWNER/REPO/pulls?state=open&per_page=30"

GraphQL example (same data, fewer round trips):

curl -H "Authorization: bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{"query": "{ repository(owner: \"OWNER\", name: \"REPO\") { pullRequests(states: OPEN, first: 30) { nodes { number title author { login } createdAt } } } }"}' \
     https://api.github.com/graphql

3. Authentication options

Method	Best for	How to use
Personal Access Token (classic)	Personal scripts, local tools	Authorization: Bearer ghp_...
Fine-grained PAT	Scoped access to specific repos	Authorization: Bearer github_pat_...
GitHub App + Installation Token	Production apps, CI/CD	Exchange JWT for installation token
OAuth App	Third-party integrations	OAuth 2.0 flow, user-delegated scopes
GITHUB_TOKEN	GitHub Actions workflows	Available automatically in Actions env