> For the complete documentation index, see [llms.txt](https://docs.trycaliber.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trycaliber.ai/connect-your-providers/github.md).

# GitHub

Connect GitHub for commit and PR metadata and AI code notes. GitLab sync is coming soon.

**Preferred auth:** GitHub App install\
**Alternative:** Personal access token\
**Who:** GitHub organization owner / admin (and a Caliber admin to click Connect)

## GitHub App

1. Open **Settings → Integrations → GitHub**.
2. Install the Caliber GitHub App on the orgs/repos you want attributed.
3. Complete the callback in Caliber.

## Personal access token

| Token type   | Scopes                            |
| ------------ | --------------------------------- |
| Classic      | `repo`                            |
| Fine-grained | `contents:read` + `metadata:read` |

## What Caliber reads

Commit metadata (author, timestamp, lines added/removed), merged PR status, repository names, and `refs/notes/ai` written by Caliber Code for AI-assisted line attribution.

## What Caliber does not read

File contents / source code through this connector (per the in-app connect guide).

## Accurate AI code %

GitHub alone is not enough for percent AI-assisted. Install **Caliber Code** (part of the Caliber station plugin) so authorship notes land in git. See [What the bundle includes](/caliber-station-plugin/what-the-bundle-includes.md) and [How the numbers are calculated](/using-caliber/how-the-numbers-are-calculated.md).

## GitLab (coming soon)

You can store a GitLab personal access token with scope `read_api` (base URL + token) under Integrations. **Commit sync is not live yet.** Do not expect GitLab attribution until sync ships; treat this as credential prep only.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.trycaliber.ai/connect-your-providers/github.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.