# GitHub

GitHub is a platform for hosting and collaborating on code repositories. Connecting GitHub to Duvo lets your assignments read and manage repositories, issues, pull requests, and more using a Personal Access Token.

## Setup

### Prerequisites

* A GitHub account with access to the repositories your assignment needs to work with.
* A Personal Access Token (PAT) generated from your GitHub account settings. Use a fine-grained token scoped to the specific repositories and permissions required.

### Required Permissions

The permissions your token needs depend on what the assignment will do. Common scopes include:

* **Contents** — Read or write files and code in repositories.
* **Issues** — Read or manage issues and comments.
* **Pull requests** — Read or create pull requests and reviews.
* **Metadata** — Required for all fine-grained tokens; allows reading repository metadata.

Grant only the permissions the assignment needs. Avoid using a classic token with broad `repo` scope if a fine-grained token with narrower access is sufficient.

### Connection Fields

| Field                     | Description                                                                                                                                                                   |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Personal Access Token** | A GitHub Personal Access Token with the permissions your assignment needs. Generate one at **Settings → Developer settings → Personal access tokens** in your GitHub account. |

### Third-Party Documentation

* [Creating a fine-grained personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token)
* [Token permission scopes reference](https://docs.github.com/en/rest/authentication/permissions-required-for-fine-grained-personal-access-tokens)

## Capabilities

* **Read repository content** — Access files, directories, branches, and commit history across your repositories.
* **Manage issues** — Create, update, close, and search issues; add labels, assignees, and comments.
* **Work with pull requests** — Open, review, merge, and comment on pull requests.
* **Search code and repositories** — Find files, functions, or content across repositories using GitHub's search API.
* **Retrieve repository metadata** — Read repository details, contributors, topics, and settings.

## Key Benefits

* **Automate developer workflows** — Triage issues, generate release notes, or open pull requests as part of a repeatable assignment.
* **Connect code to business processes** — Link repository activity to project management, reporting, and communication workflows.
* **Minimal setup** — A single Personal Access Token is all that is needed; no OAuth app or admin approval required.

## Works Well With

* **Linear or Asana** — Sync GitHub issues to a project management tool, or create GitHub issues automatically when new work items appear.
* **Slack or Microsoft Teams** — Post pull request summaries or issue updates to team channels as part of a review or release workflow.
* **Confluence or Notion** — Generate documentation or release notes from repository activity and publish them to your team wiki.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.duvo.ai/connections/available-connections/github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.