What can the GitHub integration do, and does it support GitHub Projects?

Overview

The GitHub integration enables AI agents to interact with GitHub repositories for pull request management and repository monitoring. This capability streamlines development workflows by automating common GitHub tasks.

What the GitHub Integration Can Do

Pull Request Management:

Merge pull requests with different merge methods (merge, squash, rebase)
List and filter pull requests by status
Get detailed pull request information including file changes and diffs

Repository Access:

Browse repository files and directories
Read file contents from any branch or commit
List repository branches
Track recent commits and changes

Monitoring:

Monitor repository activity
Track changes since specific commits or dates
Access all repositories you have permissions for

GitHub Projects Support

The GitHub integration does not currently support GitHub Projects. It focuses on repository-level operations like pull requests, commits, and file management.

Common Use Cases

Automatically merge approved pull requests
Generate release notes from commit history
Monitor repository activity and send notifications
Support code review workflows
Track changes for release management

Getting Started

Enable the Capability: Go to Settings → Capabilities and enable "GitHub"
Create a GitHub Token:
- Visit GitHub Settings → Personal access tokens
- Click "Generate new token (classic)"
- Select these scopes: repo, read:org, and workflow (if needed)
- Copy the token immediately
Configure:
- Paste your token in the "token" field
- Optionally specify repositories in "watchedRepositories" (e.g., yourorg/project1)
- Click "Save github Credential"