> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Set up and use the GitHub integration with Hyper AI

Auth type: OAuth

<Info>
  See general connection and permission guidance: [App Integrations](/integrations/overview).
</Info>

## Connect GitHub

1. Go to Settings → Apps in Hyper
2. Select GitHub → Connect New
3. Approve requested scopes and select repos/organizations

## Common capabilities

* Create and triage issues and PRs
* Review code and summarize changes

## Use in Chat

Enable GitHub to file issues, draft PR descriptions, and summarize diffs.

## Use in Agents

Add to toolkits and choose the connection. Require approval for write operations.

## Use in Flows

Automate triage, labeling, and release notes.

## Troubleshooting

* Missing repo access: ensure the app is installed on the target org/repo
* Permission errors: reauthorize with needed scopes

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                     | Description                                                                                |
| -------------------------- | ------------------------------------------------------------------------------------------ |
| Add Collaborator           | Add a collaborator to a GitHub repository. permission: pull, push, admin, maintain, triage |
| Add Issue Comment          | Add a comment to an existing issue                                                         |
| Add Labels                 | Add labels to a GitHub issue or pull request                                               |
| Add Pull Request Comment   | Add a review comment to specific lines in a pull request                                   |
| Add Pull Request Review    | Add a review to a pull request. event: APPROVE, REQUEST\_CHANGES, or COMMENT               |
| Compare Commits            | Compare changes between commits or branches                                                |
| Create Branch              | Create a new branch in a GitHub repository                                                 |
| Create Issue               | Create a new issue in a GitHub repository                                                  |
| Create Label               | Create a new label in a GitHub repository. color is hex without #                          |
| Create Or Update File      | Create or update a single file in a GitHub repository                                      |
| Create Pull Request        | Create a new pull request in a GitHub repository                                           |
| Create Release             | Create a new release in a GitHub repository                                                |
| Create Repository          | Create a new GitHub repository in your account                                             |
| Delete Branch              | Delete a branch from a GitHub repository                                                   |
| Delete File                | Delete a file from a GitHub repository                                                     |
| Fork Repository            | Fork a GitHub repository to your account or specified organization                         |
| Get Authenticated User     | Get the authenticated user's GitHub profile                                                |
| Get Branch                 | Get a specific branch and its HEAD commit SHA                                              |
| Get Commit                 | Get detailed information about a specific commit                                           |
| Get Default Branch         | Get the default branch of a GitHub repository                                              |
| Get Default Branch Sha     | Get the SHA of the default branch's HEAD commit                                            |
| Get File Contents          | Get the contents of a file from a GitHub repository                                        |
| Get Issue                  | Get details of a specific issue in a GitHub repository                                     |
| Get Pull Request           | Get detailed information about a specific pull request                                     |
| Get Repository Permissions | Check permissions for a user in a GitHub repository                                        |
| List Branches              | List all branches in a GitHub repository                                                   |
| List Collaborators         | List collaborators of a GitHub repository                                                  |
| List Commits               | Get list of commits of a branch in a GitHub repository                                     |
| List Directory Contents    | List contents of a directory in a GitHub repository                                        |
| List Issue Comments        | Get all comments on a GitHub issue                                                         |
| List Issues                | List issues in a GitHub repository with filtering options                                  |
| List Labels                | List all labels available in a GitHub repository                                           |
| List My Repos              | List repositories for the authenticated user                                               |
| List Pull Request Files    | List files changed in a pull request                                                       |
| List Pull Requests         | List pull requests in a GitHub repository with filters                                     |
| List Releases              | List releases in a GitHub repository                                                       |
| Merge Pull Request         | Merge a pull request. merge\_method can be "merge", "squash", or "rebase"                  |
| Push Files                 | Push multiple files to a GitHub repository in a single commit                              |
| Remove Collaborator        | Remove a collaborator from a GitHub repository                                             |
| Remove Labels              | Remove labels from a GitHub issue or pull request                                          |
| Search Repositories        | Search for GitHub repositories                                                             |
| Set Default Branch         | Change the default branch of a GitHub repository                                           |
| Update Issue               | Update an existing issue in a GitHub repository                                            |
| Update Pull Request        | Update a pull request's details                                                            |
