Github

GitHub

Full-featured GitHub integration via the gh CLI. Manage repositories, issues, pull requests, CI/CD workflows, releases, and make raw API calls.

When to Use

• Managing GitHub repositories (list, create, clone, fork, archive, delete)
• Working with issues (create, edit, close, assign, label, search)
• Managing pull requests (create, review, merge, check CI status)
• Monitoring or triggering GitHub Actions workflows
• Creating or managing releases and release assets
• Making raw GitHub REST or GraphQL API calls

When NOT to Use

• Non-GitHub version control (GitLab, Bitbucket) — use their respective skills
• Local-only git operations (commit, branch, rebase) — use git directly
• GitHub Packages or Container Registry management — use gh_api for unsupported endpoints

Tools

All tools return { "result": "..." } on success (human-readable formatted text) or { "error": "..." } on failure.

gh_repo

Manage GitHub repositories: list, view, clone, create, fork, archive, delete, rename.

Parameters:

Returns: { "result": "..." } — for view, includes name, visibility, stars, forks, languages, and URL. For list, includes a formatted list of repositories with stars, language, and description.

Examples:

• { "action": "list", "limit": 10 } — list your repositories
• { "action": "create", "name": "my-app", "private": true } — create a private repo
• { "action": "view", "repo": "owner/repo" } — view repo details

gh_issue

Manage GitHub issues: list, view, create, edit, close, reopen, comment, assign, label, search, transfer, pin, lock.

Parameters:

Returns: { "result": "..." } — for view, includes number, title, state, author, labels, assignees, body, and URL. For list, includes a formatted table of issues. For create, includes the new issue number and URL.

Examples:

• { "action": "list", "repo": "owner/repo", "state": "open" } — list open issues
• { "action": "create", "repo": "owner/repo", "title": "Bug: ...", "labels": ["bug"] } — create an issue
• { "action": "search", "query": "is:open label:bug" } — search issues

gh_pr

Manage pull requests: list, view, create, edit, merge, close, reopen, comment, review, diff, checks, ready, draft.

Parameters:

Returns: { "result": "..." } — for view, includes number, title, state, author, base/head branches, review status, and URL. For diff, includes the full diff text. For checks, includes CI check results.

Examples:

• { "action": "create", "repo": "owner/repo", "title": "Feature X", "head": "feature-x" } — create a PR
• { "action": "merge", "repo": "owner/repo", "number": 99, "merge_method": "squash" } — squash merge
• { "action": "checks", "repo": "owner/repo", "number": 99 } — check CI status

gh_workflow

Manage GitHub Actions: list workflows, view/trigger/cancel/rerun runs, view logs, list/download artifacts.

Parameters:

Returns: { "result": "..." } — for runs, includes a formatted list with run ID, status, conclusion, branch, and event. For logs, includes the run's log output. For trigger, confirms the workflow was dispatched.

Examples:

• { "action": "trigger", "repo": "owner/repo", "workflow": "ci.yml", "ref": "main" } — trigger a workflow
• { "action": "logs", "repo": "owner/repo", "run_id": "12345" } — view run logs

gh_release

Manage releases: list, view, create, edit, delete, upload/download assets.

Parameters:

Returns: { "result": "..." } — for view, includes tag, title, release notes, assets, and URL. For create, confirms the release was created with tag and URL.

Examples:

• { "action": "create", "repo": "owner/repo", "tag": "v1.0.0", "generate_notes": true } — create a release
• { "action": "list", "repo": "owner/repo" } — list releases

gh_api

Make raw GitHub API requests. Supports REST and GraphQL. Use for any endpoint not covered by other tools.

Parameters:

Returns: { "result": "..." } — the raw API response as JSON text, optionally filtered by jq.

Examples:

• { "endpoint": "/repos/owner/repo/branches", "jq": ".[].name" } — list branch names
• { "endpoint": "graphql", "query": "{ viewer { login } }" } — GraphQL query

Notes

• Requires gh CLI installed and authenticated (gh auth login)
• Requires git installed
• All tools return { "result": "..." } with human-readable formatted text or { "error": "..." } on failure
• Long outputs are truncated to prevent context overflow