GitHub Connector

Get the link to connect your GitHub account — opens GitHub's own authorization page. Use this when the user wants to connect/link their GitHub account.

Disconnect your GitHub account — removes the stored access token. GitHub's own authorization record is not revoked automatically (revoke it from github.com/settings/applications if you also want that gone); this just makes Imperal forget about it. Requires an explicit confirm=true on a second call — the first call only previews.

List the GitHub repositories your connected account has access to (owned, collaborator, and organization repos).

Create a new GitHub repository — in your personal account, or inside an organization you belong to (pass org=).

Read a file's content, or list a directory's entries, from a GitHub repository at a given ref (branch/tag/commit). Pass path='' for the repo root.

List recent commits on a GitHub repository, optionally filtered to those touching a specific path.

List contributors to a GitHub repository, ranked by number of commits.

Search for code inside a GitHub repository. Accepts GitHub's own code-search syntax (e.g. 'TODO language:python', 'def parse_args path:src') — the repo qualifier is added automatically from the repo param.

List releases (tags) published on a GitHub repository, newest first.

List pull requests on a connected GitHub repository (open by default).

Get full details of a single pull request by number — title, body, state, branches, draft status, labels, assignees, and mergeable_state.

Open a new pull request in a connected GitHub repository (head branch into base branch).

Merge an open pull request in a connected GitHub repository. This is irreversible on GitHub's side, so it requires an explicit confirm=true on a second call — the first call only previews the merge.

Submit a formal review on a pull request — APPROVE, REQUEST_CHANGES, or a plain COMMENT. This is a real GitHub review (POST /pulls/{number}/reviews), distinct from comment_on_issue_or_pr's plain issue-style comment: it shows up as an actual review verdict with the green/red badge on the PR.

List issues on a connected GitHub repository (open by default). Pull requests are excluded — use list_pull_requests for those.

Get full details of a single issue by number — title, body, state, comment count, labels, assignees.

Open a new issue in a connected GitHub repository.

Add a comment to an existing issue or pull request (GitHub treats PR comments the same way as issue comments).

Close an open pull request or issue in a connected GitHub repository (without merging). Requires an explicit confirm=true on a second call — the first call only previews the close.

Close SEVERAL issues or pull requests at once in a connected GitHub repository — the batch version of close_pull_request_or_issue, for triage. Requires an explicit confirm=true on a second call; the first call only previews which ones would close.

List recent GitHub Actions workflow runs for a connected repository — status, conclusion, and branch of each.

Trigger an existing GitHub Actions workflow in a connected repository — the workflow must already declare a workflow_dispatch trigger (this doesn't create or modify workflows, only runs one that's already there). This is the 'deploy from chat' path: it runs whatever CI/CD the user already set up.

Create a new branch in a connected GitHub repository, from an existing branch/tag/commit (defaults to the repo's default branch).

Create or update a single file in a connected GitHub repository — this IS a commit (one file per call).

Delete a branch in a connected GitHub repository. Irreversible if the branch has no other pointer to it, so it requires an explicit confirm=true on a second call — the first call only previews the deletion.

Delete SEVERAL branches at once in a connected GitHub repository — the batch version of delete_branch, for cleaning up merged feature branches. Requires an explicit confirm=true on a second call; the first call only previews which branches would be deleted.

Turn on live GitHub notifications for one repo — get notified in Imperal (bell/telegram/email per your notification settings) when an issue/PR opens, your review is requested, a PR merges, CI fails, or someone pushes to the default branch. Registers a real webhook on that repo (requires admin access to it on GitHub's side).

Turn off live GitHub notifications for one repo and remove its webhook.