What you unlock
Repository access
Browse repositories, view files, and search code across your entire GitHub organization.
Issue management
Create, update, and search issues. Assign labels, milestones, and team members directly from chat.
Pull request workflows
Review pull requests, check CI status, and manage branches through your agent.
Actions & workflows
Monitor GitHub Actions, view workflow runs, and track deployment status.
Connect GitHub
Create a Personal Access Token
Go to github.com/settings/tokens, create a Personal Access Token (classic)
with
repo, read:org, and read:user scopes, and copy it.Use a fine-grained token or a classic token scoped to only the repositories and permissions your agent needs.
Avoid using tokens with full admin access unless necessary.
Agent tools
Any agent in your workspace can use GitHub tools once a token is connected.Repositories & Code
| Tool | Description |
|---|---|
| List repositories | List repositories for a user or organization |
| Get repository | Retrieve repository details and metadata |
| Search code | Search for code across repositories |
| Get file contents | Read file contents from a specific branch or commit |
| List branches | List branches in a repository |
| List commits | View commit history with optional filters |
Issues & Pull Requests
| Tool | Description |
|---|---|
| Create issue | Create a new issue with title, body, and labels |
| List issues | List issues with filters for state, labels, assignees |
| Search issues | Search issues and PRs across repositories |
| Get pull request | Retrieve pull request details, diff, and CI status |
| List pull requests | List pull requests with state and branch filters |
| Create PR review | Submit a review on a pull request |
Actions & Workflows
| Tool | Description |
|---|---|
| List workflow runs | View recent workflow runs and their status |
| Get workflow run | Retrieve details of a specific workflow run |
| List workflows | List all workflows configured in a repository |
Triggers
Automated triggers for GitHub are not yet available. Triggers will be added in a future update — check back soon.
Example use cases
Quick code search from chat
Quick code search from chat
Ask your agent “Find where we handle authentication in the backend” and it searches across your repositories,
returning relevant file paths and code snippets.
Daily PR review summary
Daily PR review summary
An agent lists open pull requests across your team’s repositories each morning and posts a summary to your
#engineering channel — highlighting PRs waiting for review, CI failures, and stale PRs.
Create an issue from a bug report
Create an issue from a bug report
When someone reports a bug in chat, ask your agent to create a GitHub issue with the right labels, assignee, and
milestone — all populated from the conversation.
Troubleshooting
My token isn't working
My token isn't working
Make sure the token was created at github.com/settings/tokens and has the
required scopes:
repo, read:org, and read:user. If using a fine-grained token, verify it has access to the
specific repositories you need.Agent can't access private repositories
Agent can't access private repositories
Classic tokens need the
repo scope for private repository access. Fine-grained tokens need explicit repository
access grants. Check your token configuration in GitHub.Rate limiting errors
Rate limiting errors
GitHub has API rate limits (5,000 requests/hour for authenticated users). If you hit limits, wait for the reset
window or reduce the frequency of agent queries.
Organization repositories not showing
Organization repositories not showing
If your token has
read:org scope but you still can’t see org repos, check that the token is authorized for your
organization under GitHub’s Settings → Applications → Authorized OAuth Apps or SSO settings.Back to Integrations
View all available integrations