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

1. Enable the Capability: Go to Settings → Capabilities and enable "GitHub"

2. 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

3. Configure:

   • Paste your token in the "token" field
   • Optionally specify repositories in "watchedRepositories" (e.g., yourorg/project1)
   • Click "Save github Credential"