| name | github |
| description | GitHub operations: list/create issues, PRs, check CI, manage repos. Requires GH_TOKEN. |
| requires_env | ["GH_TOKEN"] |
GitHub
Manage repositories, issues, pull requests, and CI workflows on GitHub.
When to Use
- "Check my GitHub issues"
- "Create an issue for [bug]"
- "What's the status of PR #42?"
- "List open PRs on [repo]"
Auth
All requests require:
Authorization: Bearer $GH_TOKEN
Accept: application/vnd.github+json
Key Endpoints
Base URL: https://api.github.com
List Issues
curl -s "https://api.github.com/repos/OWNER/REPO/issues?state=open&per_page=10" \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json"
Create an Issue
curl -s -X POST "https://api.github.com/repos/OWNER/REPO/issues" \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json" \
-H "Content-Type: application/json" \
-d '{"title": "Bug: ...", "body": "Description...", "labels": ["bug"]}'
List Pull Requests
curl -s "https://api.github.com/repos/OWNER/REPO/pulls?state=open&per_page=10" \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json"
Comment on Issue/PR
curl -s -X POST "https://api.github.com/repos/OWNER/REPO/issues/NUMBER/comments" \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json" \
-H "Content-Type: application/json" \
-d '{"body": "Comment text..."}'
Check CI Status
curl -s "https://api.github.com/repos/OWNER/REPO/commits/REF/check-runs" \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json"
Search Issues/PRs
curl -s "https://api.github.com/search/issues?q=repo:OWNER/REPO+is:open+label:bug" \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json"
List User's Repos
curl -s "https://api.github.com/user/repos?sort=updated&per_page=10" \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json"
Notes
- Rate limit: 5000 requests/hour with token
- Use
per_page and page for pagination
- For private repos, the token needs
repo scope
- Get a token: https://github.com/settings/tokens