Developer

GitHub + AI Agents

Put your repositories in the hands of a persistent agent team — triage issues, review and merge PRs, react to failed CI, and cut releases on a schedule.

Auth: API key / tokenv1.0.1

devopsgit

Install

Auth & credentials

Auth method

API key / token

GitHub personal access token

Storage

Encrypted at rest, limited to the agents and tools you authorize, and not logged in plaintext.

Scope

Enable GitHub only for the agents that need it.

Connect: Create a classic token at github.com/settings/tokens — grant the repo scope (add workflow if you touch Actions).

What it touches: Read and write GitHub issues, pull requests, branches, files, Actions, and releases. Reads are non-mutating; writes and merges are mutating.

What your agents can do with GitHub

Concrete jobs an agent team handles with GitHub, each running on a schedule or on demand.

Capability

Auto-triage and label incoming issues, then draft responses for review

Capability

Review pull requests: pull the diff, summarize the risk, and request reviewers

Capability

React to failed CI runs — pull job logs and re-run only the failed jobs

Capability

Draft releases with a generated changelog from merged PRs

Capability

Keep a branch current and open a pull request from a generated change

Built for agent teams

Every OrgSDK integration ships with the same guarantees — this is what makes GitHub useful, not just connected.

Runs on a schedule

Agents don't just answer chats. They run on a schedule — 24/7 — so GitHub work happens even when you're asleep.

Approval gates

Agents can hold any irreversible GitHub step behind a human sign-off using the built-in approval action. Add it to a workflow where it matters — approvals are an explicit capability, not enforced on every call.

Per-agent enable

Grant GitHub only to the agents that need it. Credentials are encrypted at rest and surfaced only through an agent's enabled plugin functions when a workflow needs them.

Encrypted at rest

Your GitHub credentials are encrypted and stored per-org. OrgSDK never reads or logs them in plaintext.

Capability safety — 37 actions

Grouped from each function's source metadata. Read-only actions are non-mutating; write actions create, update, or delete data.

Read-only · non-mutating

downloadWorkflowArtifact

Get a temporary download URL for a workflow artifact (zip). The URL is short-lived. Use listWorkflowRunArtifacts first to get the artifactId.

getBranch

Get details of a specific branch including latest commit info.

getFileContent

Get the content of a file from a GitHub repository. Auto-decodes base64 to UTF-8. Errors on files >1MB. Use ref to specify a branch/tag/commit.

getIssue

Get a single GitHub issue by number.

getPullRequest

Get a single pull request by number. Includes diff stats (additions, deletions, changedFiles).

getRelease

Get a specific release by ID.

getRepo

Get details of a specific GitHub repository.

getRepoContributors

List contributors for a GitHub repository.

getWorkflowJobLogs

Download logs for a specific job. Output is capped at 100KB. Use listWorkflowJobs first to get the jobId.

getWorkflowRun

Get details of a specific workflow run by ID.

listBranches

List branches for a GitHub repository.

listDirectoryContents

List contents of a directory in a GitHub repository. Defaults to root. Use ref to specify a branch/tag/commit.

listIssueComments

List comments on a GitHub issue.

listIssues

List issues for a GitHub repository. Filters out pull requests. State: 'open', 'closed', 'all'. Labels: comma-separated string.

listPrComments

List comments on a pull request.

listPullRequests

List pull requests for a GitHub repository. State: 'open', 'closed', 'all'. head/base filter by branch name.

listReleases

List releases for a GitHub repository, ordered by creation date (newest first).

listRepos

List GitHub repositories for a user or the authenticated user. Returns simplified repo objects.

listWorkflowJobs

List jobs for a workflow run. Includes step-level detail so you can see which step failed. filter can be 'latest' (default) or 'all' (includes previous attempts).

listWorkflowRunArtifacts

List artifacts produced by a workflow run.

listWorkflowRuns

List workflow runs for a repository. Optionally filter by actionId (filename or ID), branch, status ('queued', 'in_progress', 'completed').

searchRepos

Search GitHub repositories using GitHub search query syntax. Example: 'language:typescript stars:>100'.

Write & mutating

addIssueComment

Add a comment to a GitHub issue.

addIssueLabels

Add labels to a GitHub issue. Returns the full list of labels on the issue.

addPrComment

Add a comment to a pull request.

cancelWorkflowRun

Cancel an in-progress workflow run.

createBranch

Create a new branch. fromRef defaults to the repo's default branch. Example: createBranch('owner', 'repo', 'feature/new', 'main').

createIssue

Create a new GitHub issue.

createOrUpdateFile

Create or update a file in a GitHub repository. Provide sha to update an existing file (get it from getFileContent). Content is auto-encoded to base64.

createPullRequest

Create a new pull request. head = source branch, base = target branch (e.g. 'main').

createRelease

Create a new GitHub release. tagName is required. targetCommitish defaults to the default branch.

mergePullRequest

Merge a pull request. mergeMethod: 'merge', 'squash', or 'rebase'. Defaults to 'merge'.

requestPrReview

Request reviewers for a pull request.

rerunWorkflow

Re-run all jobs in a workflow run. Returns immediately — poll getWorkflowRun to track progress.

rerunWorkflowFailedJobs

Re-run only the failed jobs of a workflow run. Returns immediately — poll getWorkflowRun to track progress.

triggerWorkflow

Trigger a workflow_dispatch event. actionId can be the workflow filename (e.g. 'ci.yml') or numeric ID. ref is the branch/tag to run on.

updateIssue

Update a GitHub issue. Only provided fields are changed. State: 'open' or 'closed'.

How install works

Plans start at $58/mo. Every org runs in its own isolated cloud environment.

01
Choose a plan
Starter or Pro. Your managed workspace is ready in seconds.
02
Install
Add GitHub from the plugin directory — one click, no config files.
03
Connect & enable
Authorize GitHub, then enable it for the agents that need it.

Put GitHub in the hands of a persistent agent team.

Choose Starter or Pro, create your org, and install GitHub in minutes.

Get started