1. Docs
2. /
3. Tool reference
4. /
5. GitHub & Code

GitHub & Code

Repos, issues, pull requests, code search, the read/branch/commit path to opening a PR, and editing and commenting on it once open.

26 verbs in this family.

• cancelArmedMerge write Cancel one GitHub pull request merge-when-green arm: the Cloud's armed row AND GitHub's own auto-merge on that pull request, which it disables with the repo's deploy identity token (TYBK for…
• commentOnPullRequest writeexternal Leave a plain comment on a connected GitHub repo's pull request, in its conversation.
• commitFiles writeexternal Commit one or more files to a feature branch on a connected GitHub repo (multi-file atomic commit).
• createBranch writeexternal Create a branch on a connected GitHub repo from a named base.
• createIssue writeexternal Create an issue in a GitHub repository.
• getPullRequest readexternal Get one GitHub pull request in detail: diff stats, GitHub's mergeableState (clean / dirty / blocked / behind / unstable / unknown), and the check runs on its head commit as `checks` with…
• getPullRequestDiff readexternal Read a bounded unified diff for one GitHub pull request.
• listArmedMerges read List the caller's active GitHub pull requests that are armed to merge when required checks pass.
• listGatekeepRules read List GateKeep rule packs for a GitHub connection.
• listIssues readexternal List issues for a GitHub repository.
• listPullRequests readexternal List pull requests for a GitHub repository.
• listRepos readexternal List the user's GitHub repositories across every connected account.
• listRepoTree readexternal Browse a connected GitHub repo's file tree at a ref, optionally scoped to a path and depth.
• listShepherdLedger read List Shepherd ledger entries for a GitHub connection.
• mergePullRequest writedestructiveconsentexternal Request a merge of a connected GitHub repo's pull request.
• openPullRequest writeexternal Open a pull request on a connected GitHub repo.
• openRepoPreflight readexternal Measure whether a connected GitHub repository is ready to open: one PASS or FAIL row per gate (LICENSE present and OSI-recognized, SECURITY.md, CONTRIBUTING.md, pull request template, issue…
• readDeliveryRecord readexternal Measure what a GitHub repository delivered in a dated window, in one call: merges to the default branch (count and list with sha, title, date, author), merged pull requests grouped by author,…
• readRepoFile readexternal Read one file from a connected GitHub repo at any ref: the reliable read path for drafting a diff in chat.
• reviewPullRequest writedestructiveexternal Submit a review on a connected GitHub repo's pull request: APPROVE, REQUEST_CHANGES, or COMMENT, acting as the user's connected GitHub account.
• searchCode readexternal Search code across the user's GitHub repositories with GitHub code-search syntax.
• setMergeApprovals writeconsent Request a change to a connected GitHub account's "Merge approvals" dial, the standing consent that decides whether a green pull request merges on its own or waits for the owner.
• shepherdRunNow writedestructiveexternal Run Shepherd now for a repository, with one pull request as the immediate review focus.
• shepherdStatus read Read Shepherd status for a connected GitHub account: last fire, when the owner's cadence is next due, the dial, and how many ledger rows the bounded recent window held.
• updateGatekeepRule write Create a new versioned repo-scoped GateKeep rule pack.
• updatePullRequest writeexternal Edit an open pull request on a connected GitHub repo: retitle it, replace or patch its body, retarget its base, or move it in or out of draft.