| name | github |
| version | 1.0.0 |
| description | Use when working with GitHub repositories, issues, pull requests, branches, or commits and the task needs authenticated repository operations or GitHub metadata. |
| activation | {"keywords":["github","issues","pull request","repository","commit","branch"],"exclude":["gitlab","bitbucket"],"patterns":["list.*issues","show.*issue","get.*issue","create.*issue","list.*pull","create.*pull","get.*repo","list.*branches","list.*commits"],"tags":["git","code-review","devops"],"max_context_tokens":2000} |
GitHub Integration
Prefer the GitHub plugin when it is available. Otherwise prefer the gh CLI for authenticated operations in this repository. Only use the REST API directly when the environment explicitly supports injected GitHub credentials.
Preflight
Before doing any write action:
- Confirm the target repository.
- Confirm
gh auth status succeeds if you plan to use the CLI.
- Confirm issue titles, PR titles, labels, and comment bodies with the user before creating or posting.
Common gh Commands
Issues
gh issue list --state open --limit 100
gh issue view <number> --json number,title,body,labels,comments,assignees,milestone
gh issue create
gh issue comment <number> --body "<text>"
Pull Requests
gh pr list --state open --limit 100
gh pr view <number> --json number,title,body,author,files,labels,reviews,comments,statusCheckRollup
gh pr diff <number>
gh pr checkout <number>
gh pr create
gh pr comment <number> --body "<text>"
gh pr review <number> --comment --body "<text>"
Repository
gh repo view --json name,owner,defaultBranchRef
gh api repos/{owner}/{repo}/branches
gh api repos/{owner}/{repo}/commits
REST API Fallback
Use direct API calls only when the environment supports them.
- Base URL:
https://api.github.com
- Header:
Accept: application/vnd.github+json
- Never add an
Authorization header unless the environment explicitly requires manual auth.
- Prefer
per_page=100 for paginated endpoints.
Rules
- Prefer GitHub plugin or
gh over raw HTTP when both are available.
- Confirm all write actions with the user before creating, editing, commenting, reviewing, or merging.
- Summarize large diffs instead of dumping raw output unless the user asks for it.
- If authentication or repo context is missing, stop and surface the exact blocker.
