---
title: "GitHub"
description: "Connect repositories so agents can branch, push code, and open pull requests."
---

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

# GitHub

GitHub is the backbone of Trevize. Connecting it lets Trevize **sync your
repositories and issues** and gives agents what they need to **create branches,
push code, and open pull requests** — so every piece of agent work lands as a PR
you review.

## Connect GitHub

You connect GitHub by installing the **Trevize GitHub App** and authorizing the
repositories it can access.

1. **Install the app**

   From your workspace's integration settings, choose **Install GitHub App** (or
   **Add account** if you've already connected one). You'll be taken to GitHub to
   pick an account or organization and select which repositories to grant access to.

2. **Approve, if required**

   If you install into an organization, an org admin may need to approve the
   installation first. Trevize will let you know it's pending — once approved, the
   account becomes available.

3. **Manage connected accounts**

   Connected accounts appear under **Connected Accounts**, each showing the account,
   its type (user or organization), a **Configure** link (which opens the
   installation's settings on GitHub, where you can change repository access), and a
   control to remove it. You can connect more than one account.

## How it's used

Once connected, GitHub repositories are selectable when you start a
[session](/concepts/sessions), a [task](/concepts/tasks), or an
[automation](/concepts/automations). Agents work on a branch and open a pull
request; the run tracks the PR's status (open, draft, merged, closed) with a link
back to GitHub.

> **Scope access deliberately**
>
> You control exactly which repositories the GitHub App can touch. Grant access
> to only the repos you want Trevize to work in, and adjust it anytime from
> **Configure**.

Source: https://docs.trevize.dev/integrations/github/index.mdx