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

# GitHub

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

## Setup

<Steps>
  <Step title="Confirm prerequisites" icon="circle-check">
    <Check>A GitHub account with access to the repositories your agent needs to work with.</Check>
    <Check>A Personal Access Token (PAT) generated from your GitHub account settings. Use a fine-grained token scoped to the specific repositories and permissions required.</Check>

    <Tip>
      Need a token? Follow [GitHub's guide to 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).
    </Tip>
  </Step>

  <Step title="Grant the required permissions" icon="key">
    The permissions your token needs depend on what the agent 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.

    <Warning>
      Grant only the permissions the agent needs. Avoid using a classic token with broad `repo` scope if a fine-grained token with narrower access is sufficient.
    </Warning>
  </Step>

  <Step title="Add the connection in Duvo" icon="plug">
    On the [Connections page](https://app.duvo.ai/integrations), open GitHub and fill in these fields:

    <ParamField body="Personal Access Token" type="string" required>
      A GitHub Personal Access Token with the permissions your agent needs. Generate one at **Settings → Developer settings → Personal access tokens** in your GitHub account.
    </ParamField>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Third-party documentation" icon="book">
    * [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)
  </Accordion>
</AccordionGroup>

## 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 agent.
* **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; OAuth app setup is not required, though organization policies may require admin approval.

## Works Well With

<CardGroup cols={3}>
  <Card title="Linear" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/linear.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=bad444a975b99c9a5defc63e09c209ec" href="/user-guide/connections/available-connections/linear" width="200" height="200" data-path="images/connections/linear.svg">
    Sync GitHub issues to a project management tool, or create GitHub issues automatically when new work items appear.
  </Card>

  <Card title="Asana" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/asana.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=f510d4331a354081a910c80021210da7" href="/user-guide/connections/available-connections/asana" width="24" height="24" data-path="images/connections/asana.svg">
    Sync GitHub issues to a project management tool, or create GitHub issues automatically when new work items appear.
  </Card>

  <Card title="Slack" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/slack.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=8a64bdd1af39e903923e4a273b4a4618" href="/user-guide/connections/available-connections/slack" width="512" height="512" data-path="images/connections/slack.svg">
    Post pull request summaries or issue updates to team channels as part of a review or release workflow.
  </Card>

  <Card title="Microsoft Teams" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/teams.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=6402a90678b560d0b0a4fc3b02c0d3e0" href="/user-guide/connections/available-connections/microsoft-teams" width="2229" height="2073" data-path="images/connections/teams.svg">
    Post pull request summaries or issue updates to team channels as part of a review or release workflow.
  </Card>

  <Card title="Confluence" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/confluence.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=297223b9d35edcb9cb3e910f66edcb49" href="/user-guide/connections/available-connections/confluence" width="512" height="512" data-path="images/connections/confluence.svg">
    Generate documentation or release notes from repository activity and publish them to your team wiki.
  </Card>

  <Card title="Notion" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/notion.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=2e0eadf63c9c3c835ada9923e18d3039" href="/user-guide/connections/available-connections/notion" width="800" height="800" data-path="images/connections/notion.svg">
    Generate documentation or release notes from repository activity and publish them to your team wiki.
  </Card>
</CardGroup>
