korvu
Self-host CoreJoin Cloud waitlist
docs/get started
Search documentation…⌘ K
DocsGet startedInstall the GitHub App

Install the GitHub App

Install the Korvu GitHub App on your org or user account so Korvu can review pull requests.

The Korvu GitHub App is how Korvu authenticates, receives webhooks, and posts review comments on your pull requests. Install it once per GitHub org or user account.

Requirements

  • A GitHub user or organization that owns the repo you want to review
  • admin access on the org (for org installs) or repo owner (for user installs)
  • A Korvu workspace — Cloud is on a waitlist pre-GA; self-hosted Core works today

Install via the Korvu app

The easiest path: from the Korvu app, click Connect GitHub. We'll redirect you to GitHub, ask which org or repos to install on, and finish the handshake automatically.

  1. Sign in to Korvu and open the Connect GitHub screen.
  2. Pick an org or user account.
  3. Choose All repositories or select repos individually.
  4. Approve the requested permissions.
  5. You're redirected back to Korvu — the install is live.

Permissions Korvu requests

Korvu asks for the minimum permissions needed to review code and post results:

  • Read on contents, pull requests, metadata, and checks
  • Write on pull requests and checks (to post comments and status)
  • Webhook subscription on PR open, sync, reopen, and review events

Korvu does not request access to actions, secrets, or admin scopes.

Verify the install

After connecting, head to your repo and open a fresh pull request. Within ~30s you should see:

  • A Korvu check appear in the PR's checks list
  • A summary comment from @korvu-ai
  • Inline comments on any findings (if the diff has any)

If nothing appears within two minutes, see Troubleshooting below.

Troubleshooting

No check or comment after 2 minutes. Open the Reviews tab in Korvu — if you don't see a row for your PR, the webhook didn't arrive. Check the install's webhook delivery log in GitHub: Org → Settings → GitHub Apps → Korvu → Recent Deliveries.

403 on webhook delivery. Your install token may have expired during a re-auth event. Re-install the app from the Korvu app to refresh credentials.

Reviews stop after a repo rename. GitHub rewrites the install's repo list on rename. Refresh the install from the Korvu app, or wait for the next periodic resync (every 15 minutes).

← PreviousQuickstart