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

# GitHub

> Manage repositories, issues, and pull requests

## At a glance

* **Availability**: Enabled by default.
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `repo`, `read:user`, `read:org`.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable               | Required | Description                                                                    |
| ---------------------- | -------- | ------------------------------------------------------------------------------ |
| `GITHUB_CLIENT_ID`     | Yes      | GitHub OAuth App Client ID [Docs](https://github.com/settings/developers).     |
| `GITHUB_CLIENT_SECRET` | Yes      | GitHub OAuth App Client Secret [Docs](https://github.com/settings/developers). |

## Tools

| Tool                | Access | Description                                                                                                                       |
| ------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------- |
| Get Current User    | Read   | Get the authenticated GitHub user identity                                                                                        |
| List Repositories   | Read   | Get list of user's repositories                                                                                                   |
| Get User            | Read   | Get a GitHub user profile by username. Use this to verify repository owners, assignees, and other GitHub usernames before acting. |
| Get Repository      | Read   | Get details of a specific repository                                                                                              |
| List Pull Requests  | Read   | Get pull requests for a repository                                                                                                |
| Create Issue        | Write  | Create a new issue in a repository                                                                                                |
| Get PR Diff         | Read   | Get the diff for a pull request                                                                                                   |
| List Issues         | Read   | List issues for a repository                                                                                                      |
| Get Issue           | Read   | Get details of a GitHub issue                                                                                                     |
| Update Issue        | Write  | Update, close, or reopen a GitHub issue                                                                                           |
| Add Issue Comment   | Write  | Add a comment to a GitHub issue or pull request                                                                                   |
| Get Pull Request    | Read   | Get details of a specific pull request (title, body, status, author, reviewers, labels)                                           |
| Create Pull Request | Write  | Create a new pull request in a repository                                                                                         |
| Merge Pull Request  | Write  | Merge an open pull request                                                                                                        |
| List Commits        | Read   | List commits for a repository, branch, or file path                                                                               |

## Example prompts

* Show me my open pull requests and help me review them. Summarize the changes and any comments.
* Help me create a new GitHub issue with a clear description and appropriate labels.
* Summarize the recent commits in my repository and highlight significant changes.