Read your GitHub pull requests, their checks, the latest release and how a branch compares with main, on your own token. Read-only: five GET verbs, no write. "Merged" and "checks green" are read from GitHub, not taken from a report.
What your agent can do with it
- github_apiAuthenticated READ access to the GitHub REST API. `config.baseUrl` pins api.github.com; `config.auth` injects the vaulted token as `Authorization: Bearer <token>`. Only this capab…
- github_pr_getOne pull request: is it open, closed or merged, and with which commit. Use it to check "merged" yourself instead of trusting a report. Returns { number, title, state ('open' | 'cl…
- github_pr_checksThe check runs on one commit — what CI says about a pull request's head. Pass the pull request's headSha (from github_pr_get) or a branch name as `ref`. Each run has { name, statu…
- github_release_latestThe latest published release of a repository (drafts and pre-releases are not "latest"). Use it to tell which version is out. Returns { tag, name, publishedAt, targetCommitish, ur…
- github_compareHow a branch or commit stands against a base: is it behind main, and by how much; does a deployed sha contain a merge commit (compare base = the merge commit, head = the deployed …
- github_check_pr_mergedA criterion CHECK: is a pull request merged? Returns { passed, detail, merged, state, mergeCommitSha, url } — `passed` is what a session criterion reads. As a capability criterion…
What you will need
Asked for at install. Stored in your pod, never on our servers.
- GitHub token (read-only)A GitHub personal access token, read-only. Fine-grained (recommended): Repository access = the repositories you want the pod to read; Permissions = Pull reques…
- {{name}} GitHub token (read only)SecretThe person's own read-only GitHub token, used by every github_* verb of this capability. Not pod-wide: an agent needs a vault grant from its owner to read thro…