Skip to main content

GitHub

27 tools covering repos, issues, the complete PR lifecycle, and GitHub Actions/CI. Implemented in tools/githubOps.js.

Setup

  1. Go to github.com/settings/tokens
  2. Generate a token (classic or fine-grained) with repo scope — add workflow scope too if you want github_rerun_workflow to work
  3. Add it to .env as GITHUB_TOKEN

Repos & issues

ToolRiskWhat it does
github_get_authenticated_userREADGet the authenticated user's profile
github_list_reposREADList repositories for the authenticated user
github_get_repoREADGet a repository's details (default branch, visibility, language, etc.)
github_create_repoHIGHCreate a new repository
github_delete_repoDESTRUCTIVEDelete a repository
github_list_issuesREADList issues on a repository
github_get_issueREADGet a single issue's details
github_create_issueMEDIUMCreate an issue
github_update_issueMEDIUMUpdate an issue's title, body, state, or labels
github_add_commentMEDIUMAdd a comment to an issue or pull request

Pull requests

ToolRiskWhat it does
github_list_pull_requestsREADList pull requests
github_get_pull_requestREADGet a single PR's details, including mergeable status
github_create_pull_requestMEDIUMCreate a pull request
github_update_pull_requestMEDIUMUpdate a PR's title, body, state, or base branch
github_merge_pull_requestHIGHMerge a pull request
github_get_pull_request_diffREADGet the full raw diff of a PR
github_get_pull_request_filesREADList files changed in a PR, with additions/deletions
github_get_pull_request_commentsREADList conversation comments on a PR
github_get_pull_request_reviewsREADList reviews (approved/changes-requested/commented)

Branches

ToolRiskWhat it does
github_get_branchREADGet a single branch's details, including protection status
github_list_branchesREADList branches on a repository

Actions / CI

ToolRiskWhat it does
github_list_workflowsREADList workflows defined in a repository
github_list_workflow_runsREADList recent workflow runs, optionally filtered by branch/status
github_get_workflow_runREADGet details of a single run (status, conclusion, timestamps)
github_get_workflow_run_jobsREADList jobs in a run, with per-step status
github_get_job_logsREADGet the raw log text for a specific failed job
github_rerun_workflowMEDIUMRe-run a workflow run

Example

"Find the latest failing CI run on the main branch and show me why it failed."

Claude calls github_list_workflow_runs (filtered to main, failed status) → github_get_workflow_run_jobsgithub_get_job_logs for the failing job — the exact sequence fix_ci automates for you.

See also: Workflow toolsship_change and fix_ci chain several of these GitHub tools together into a single verified action.