GitHub

What your agent can do

• Read repository contents and file structure
• Create, read, update, and close issues
• List and review pull requests
• Post comments on issues and PRs
• Create branches and commits
• Read CI/CD workflow status

---

Connecting GitHub

1. Go to Console → Integrations → GitHub
2. Click Connect GitHub
3. You’ll be redirected to GitHub’s authorization page
4. Choose all repositories or selected repositories
5. Click Authorize Auteryn

Personal vs. bot account

A personal GitHub connection acts as you and is private to you by default — teammates can’t use it until you share it, and it’s automatically revoked when you’re offboarded. A GitHub bot account (a GitHub user created specifically for this purpose) is shared with the team and stays durable if any one member leaves. For team use, connect with a bot account rather than a personal one.

---

Permissions

After connecting, open the connection in Integrations → GitHub to review scopes granted during OAuth. GitHub permissions map to what the agent can do via the GitHub integration and gh CLI (when enabled):

Permission	What it allows
read:repositories	List and read repo contents
read:issues	Read issue titles, descriptions, comments
write:issues	Create issues, add labels, close issues
read:pull_requests	Read PR details and code diff
write:pull_requests	Post comments on PRs
read:commits	Read commit history
write:commits	Create commits and push to branches
read:workflows	Read GitHub Actions run status

Start with read-only permissions and add write permissions only when needed.

---

Example tasks

• “Check the open issues in acme/backend labeled ‘bug’ and summarize them”
• “Create a GitHub issue: title ‘Login timeout’, priority High, assigned to @alice”
• “Review the diff in PR #42 and flag any obvious security issues”
• “List all PRs waiting for review that are older than 3 days”
• “What was the last commit message on the main branch?”