Connect GitHub to your agents for managing repositories, issues, and pull requests.

GitHub Integration

GitHub provides access to repositories, issues, and pull requests. Your agents can browse code, create and manage issues, review pull requests, and more.

OAuth Setup

When you click Connect GitHub on the dashboard, Supyagent requests the following scopes:

Scope	Access
`repo`	Full access to repositories (read/write code, issues, PRs)
`read:user`	Read user profile information
`read:org`	Read organization membership

Permissions

Permission ID	Name	Type	Description
`github.repos.read`	Read repositories	read	View repositories and their contents
`github.issues.read`	Read issues	read	View issues and comments
`github.issues.write`	Manage issues	write	Create and update issues
`github.prs.read`	Read pull requests	read	View pull requests and reviews
`github.prs.write`	Manage pull requests	write	Create and update pull requests

Repositories

Example Actions

List user repositories:

curl -X GET "https://app.supyagent.com/api/v1/github/repos?sort=updated&limit=20" \
  -H "Authorization: Bearer sk_live_..."

Get repository details:

curl -X GET "https://app.supyagent.com/api/v1/github/repos/owner/repo-name" \
  -H "Authorization: Bearer sk_live_..."

Get file contents:

curl -X GET "https://app.supyagent.com/api/v1/github/repos/owner/repo/contents/src/main.py" \
  -H "Authorization: Bearer sk_live_..."

What Agents Can Do

List repositories (personal and organization)
Browse repository file trees
Read file contents at specific branches/commits
View repository metadata (stars, forks, language, topics)

Issues

Example Actions

List open issues:

curl -X GET "https://app.supyagent.com/api/v1/github/repos/owner/repo/issues?state=open" \
  -H "Authorization: Bearer sk_live_..."

Create an issue:

curl -X POST "https://app.supyagent.com/api/v1/github/repos/owner/repo/issues" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Bug: Login page timeout on slow connections",
    "body": "## Steps to Reproduce\n1. Throttle network to 3G\n2. Navigate to /login\n3. Submit form\n\n## Expected\nLoading indicator appears\n\n## Actual\nPage hangs with no feedback",
    "labels": ["bug", "frontend"]
  }'

Add a comment to an issue:

curl -X POST "https://app.supyagent.com/api/v1/github/repos/owner/repo/issues/42/comments" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"body": "Investigated this. The timeout is set to 5s. Increasing to 30s should fix it."}'

What Agents Can Do

List, search, and filter issues
Create new issues with titles, descriptions, and labels
Comment on existing issues
Close or reopen issues
Assign issues to users

Pull Requests

Example Actions

List open pull requests:

curl -X GET "https://app.supyagent.com/api/v1/github/repos/owner/repo/pulls?state=open" \
  -H "Authorization: Bearer sk_live_..."

Create a pull request:

curl -X POST "https://app.supyagent.com/api/v1/github/repos/owner/repo/pulls" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Fix login timeout",
    "body": "Increases the login form timeout from 5s to 30s.\n\nFixes #42",
    "head": "fix/login-timeout",
    "base": "main"
  }'

What Agents Can Do

List and filter pull requests by state, author, or label
View PR diffs and file changes
Create pull requests
Add review comments
Merge pull requests

Notes

The repo scope provides broad access -- consider using fine-grained permissions on the dashboard to restrict what your agents can do
GitHub API rate limits apply: 5,000 requests per hour for authenticated requests
File contents are returned Base64-encoded for binary files; text files are returned as plain text
For large repositories, paginate results using the page and per_page parameters

GitHub

On this page