# GitHub integration

GitHub hosts repositories, issues and pull requests.

## What agents can do

Ask an agent to read an issue and draft a triage summary. Issue creation and comments need write access. Project pull requests can be merged only through an approved project ticket.

### Reads
- List accessible repositories
- Read an issue
- List merged pull requests

### Changes
- Create an issue
- Comment on an issue

### Changes that need approval
- Merge a project's pull request after its approval ticket is approved

## Example prompts
- Read issue 42 and summarize what needs investigation.
- Create an issue from this bug report.
- Draft a comment on issue 42 describing the next investigation step.

## Connection details
Category: Development and projects
How you connect: GitHub App installation
- Selected repositories: Read and change code only in repositories selected during GitHub App installation.
- Selected repositories: read only: Read code, issues, and pull requests in repositories selected during GitHub App installation. Nothing here can create an issue, post a comment, or merge.

## Sources
- [GitHub App permissions](https://docs.github.com/en/apps/creating-github-apps/setting-up-a-github-app/choosing-permissions-for-a-github-app)

## Setup

1. Choose GitHub App in Integrations.
2. Install the app on the account and repositories you want to share.
3. Return to the workspace and test with a read-only issue summary.

[Create a workspace](https://agents.deploy-hermes.com/signup)
