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

# GitHub integration for Palette Context Library

> Palette connects to GitHub, reads PRs, issues, reviews, and deployments from repos you choose. It reads activity only, never source code or file contents.

Palette connects to your GitHub organization and reads activity from the repos you choose.

| Capability       | Details                                                                 |
| ---------------- | ----------------------------------------------------------------------- |
| **Reads**        | PRs, issues, comments, reviews, deployments, repo metadata, org members |
| **Doesn't read** | Source code, file contents, diffs, commit details, CI/CD results        |
| **Scope**        | Per-workspace. Installs as a GitHub App on your organization.           |

## What Palette reads

* Pull requests (opened, closed, merged, edited)
* Issues (opened, closed, edited)
* Issue and PR comments
* PR reviews
* Deployments
* Repository metadata (name, description, default branch)
* Org members (username, email, role)

## What Palette doesn't read

* Source code, file contents, or diffs
* Commit messages or details
* CI/CD results or workflow runs
* Branch protection rules
* Repository secrets or settings

Palette reads the activity feed, not the actual code. It never scans your codebase, reads file contents, or accesses source code.

## What you control

You choose which repos to connect. Individual repos can be enabled or disabled per Palette team. Disconnect a repo and Palette stops reading it.

## Connection

Per-workspace. Palette installs as a GitHub App on your organization. Users are mapped individually between Palette and GitHub.

See [How the Context Library works](/docs/os/how-it-works) for the full picture, or go back to the [Context Library quick start](/docs/os/quickstart).