Skip to main content

​
Overview

Greptile integrates with GitHub and GitLab to provide automated code reviews on your pull requests and merge requests. The setup process differs between the two platforms.
GitHub, GitLab, and GitHub Enterprise Server are supported (email hello@greptile.com for GHES access)

​
GitHub Integration

GitHub integration uses the Greptile Apps GitHub App, which handles authentication and permissions automatically.

​
Setup

You’ll be guided through GitHub App installation during onboarding. The process includes:
  1. Installing the GitHub App - You’ll be redirected to GitHub to authorize the Greptile Apps installation
  2. Granting repository access - Select which repositories Greptile can access:
    • All repositories - Grant access to all current and future repos
    • Select repositories - Choose specific repos to enable
  3. Configuring reviews - Select which repositories to actively review at app.greptile.com/review/github

​
Managing Your Installation

After initial setup, you can manage your GitHub integration: All Greptile actions (comments, reviews, reactions) are performed as the GitHub App.

​
GitLab Integration

You’ll be guided through GitLab integration during onboarding. The setup requires a group access token and webhook configuration for automatic reviews.

​
Authentication Setup

1

Create Group Access Token

Create a group access token to grant Greptile access to all repositories in your group.
  1. Navigate to your GitLab group
  2. Go to Settings → Access Tokens
  3. Create a new token with:
    • Name: Greptile (or your preferred name)
    • Role: Developer
    • Scopes: api
    • Expiration: Set to maximum (1 year)
  4. Copy the token immediately - you won’t be able to see it again
2

Add Token to Greptile Dashboard

You’ll be prompted to add your token during onboarding. You can update it later at app.greptile.com/connections/code-providers.

​
Webhook Configuration

Webhooks enable automatic code reviews when merge requests are opened or updated. Without webhooks, you can still trigger reviews manually. We recommend setting up webhooks at the group level to apply to all repositories in the group.
1

Get Webhook Details

Retrieve your webhook URL and secret from the Greptile dashboard:
  1. Go to app.greptile.com/review/gitlab
  2. Copy the webhook secret displayed on the page (unique to your Greptile organization - do not share)
  3. Note the webhook URL: https://talon.greptile.com/webhook
You can retrieve your webhook secret anytime by clicking the gear icon at app.greptile.com/review/gitlab
2

Configure GitLab Webhook

Set up the webhook in your GitLab group:
  1. Navigate to your GitLab group
  2. Go to Settings → Webhooks
  3. Add a new webhook with:
    • URL: https://talon.greptile.com/webhook
    • Secret Token: Paste the secret from Greptile dashboard
    • Trigger events: Enable the following:
      • Comments
      • Issue events
      • Merge request events
      • Emoji events
    • Enable SSL verification: Recommended
  4. Click Add webhook
⌘I