Zest
Docs / GitHub

Zest GitHub App

Connect your repos so Zest can tie AI sessions to the PRs they produced.

GitHub logo

GitHub is an integration, not an editor plugin — there is nothing to install locally. You connect it once from your Zest workspace and it applies to everyone on the team.

Connect

New to Zest? Create your account first. Free for 3 seats, no credit card.

Create a free account
  1. 1

    Open GitHub in Zest's settings

    Sign in to Zest on the web and open Settings → GitHub. You need to be an owner or admin of the workspace to connect it.

    Open GitHub settings
  2. 2

    Install the Zest GitHub App

    Click "Install the GitHub app". GitHub asks which organization to install into and which repositories to grant access to. Zest reads pull requests, reviews and commits — it never writes to your code. Installed it before? Click "Already installed? Link it" instead.

  3. 3

    Pick the repositories to track

    Choose every repository, or select them one by one. You can change the selection later from GitHub's app settings without reconnecting, and switch a repository off in Settings → GitHub.

  4. 4

    Wait for the first sync

    Zest backfills the last 30 days of pull requests, reviews and commits as soon as the app is linked. Larger organizations can take a few minutes; Settings → GitHub shows the progress.

  5. 5

    Check PR throughput

    Open Zest. Merged PRs are now matched to the AI sessions that produced them, so throughput sits next to the prompts and models behind it.

Check it works

Settings → GitHub lists each linked installation as connected, with its repositories and the state of the history sync. An owner or admin can run “Sync the last 30 days now” once every 10 minutes.

What Zest reads

From GitHub

  • Pull requests: title, author, branches, state, sizes, who merged it and when, and whether a known AI reviewer reviewed it and what it flagged.
  • Reviews, and how many comments each pull request got from people and from bots.
  • Commits on the default branch.

What Zest keeps

  • The pull requests, reviews and commits above, stored under your workspace and matched to the AI sessions that opened them, by repository and branch.

When it syncs

Live: GitHub sends each pull request, review and comment event as it happens. History: when you link the app, when you add repositories, and when an admin asks, Zest backfills the last 30 days (or less, if your workspace keeps raw data for less).

What Zest leaves out

  • Pull request descriptions, comment text and the code around review comments: dropped before anything is stored.
  • Repositories you switch off in Settings → GitHub: their events and history are skipped.
  • Nothing is written to GitHub: every token Zest asks for is read-only.

Stop or disconnect

Stop tracking a repository

Switch it off in Settings → GitHub.

Disconnect

Uninstall the Zest GitHub App from your organization's settings on GitHub. Zest stops receiving events and keeps what it has until its retention runs out.

Troubleshooting

The connect buttons are missing

Only an owner or admin of the workspace can connect GitHub or change its repositories. Ask one of them.

The app is installed on GitHub but not in Zest

Click “Already installed? Link it” and pick the installation. Your GitHub account must be able to see it.

“Installation linked elsewhere”

That installation is already linked to another Zest workspace. An installation belongs to one workspace at a time.