Skip to content
Nimbus

GitHub

The GitHub connector is the canonical first-party connector. It indexes pull requests and issues into the local SQLite index and exposes a wide read surface across repositories, PRs, issues, and Actions runs, plus a HITL-gated write surface for the operations on-call engineers reach for most: merging PRs, creating issues, deleting branches.

What’s indexed

Section titled “What’s indexed”
  • Service id: github
  • Item types: pr, issue

Authenticate

Section titled “Authenticate”
Terminal window
nimbus connector auth github

Stored in the Vault as github.pat and injected at spawn as GITHUB_PAT. Use a fine-grained personal access token scoped to the repositories you want indexed.

Read tools (no HITL)

Section titled “Read tools (no HITL)”

| Tool | Purpose | |---|---| | github_ci_run_get | Get a single workflow run including jobs URL reference. | | github_ci_runs | List GitHub Actions workflow runs for a repository. | | github_issue_get | Get a single issue by number. | | github_issue_list | List issues for a repository. | | github_pr_get | Get a single pull request by number. | | github_pr_list | List pull requests for a repository. | | github_repo_get | Get repository metadata (owner/repo). | | github_repo_list | List repositories the authenticated user owns or collaborates on. |

Write tools (HITL-gated)

Section titled “Write tools (HITL-gated)”

Every tool below requires interactive consent through the Gateway HITL gate before it executes.

| Tool | Purpose | |---|---| | github_branch_delete | Delete a branch by ref name. | | github_issue_create | Create a new issue in a repository. | | github_pr_close | Close a pull request without merging. | | github_pr_merge | Merge a pull request. | | github_tag_create | Create a lightweight tag pointing at a commit SHA. |

See also

Section titled “See also”