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

GitHub & Code

Repos, issues, pull requests, code search, and the read/branch/commit path to opening a PR.

22 verbs in this family.

• cancelArmedMerge write Cancel one active GitHub pull request merge-when-green arm.
• 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.
• 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.