5-Minute Quickstart

Open Code Providers

Go to Code Providers. Click Connect GitHub Cloud or Add Provider, then select GitHub.

Choose a GitHub account or organization

In GitHub, choose the account or organization where you want to install Greptile Apps. Use Configure for an existing installation.

Grant repository access

Select which repositories GitHub lets Greptile access:

• All repositories: Grant access to all current and future repositories in the account or organization.
• Only select repositories: Grant access only to selected repositories. Select at least one repository.

Click Install or Update access.

Link the GitHub organization in Greptile

After you click Install, GitHub automatically returns you to Greptile. Select the GitHub organization, then click Link.You can add more organizations later from Code Providers.

If your GitHub organization is missing from this list, see Troubleshooting: GitHub organization not listed.

Enable repositories for review

Select the repositories you want Greptile to review, then click Enable.Use Enable All to turn on all repositories that GitHub granted access to.

Open GitLab integration

Go to Code Providers in Greptile and click Add Provider, then select GitLab. Greptile shows the token requirements and a field for the generated token.

Open access tokens in GitLab

In GitLab, open your project or group, then go to Settings → Access tokens.

Create the access token

Create a token with:

• Token name: Greptile
• Role: Developer
• Scope: api
• Expiration date: the latest allowed date

Copy the generated token

Copy the token. GitLab only shows it once.

Submit the token in Greptile

Paste the token into the GitLab integration modal, then click Submit.

Link the GitLab group

Select the GitLab group, then click Link.

Enable repositories for review

Select the GitLab repositories you want Greptile to review, then click Enable.Use Enable All to turn on every listed repository.

Enable repository indexing by Greptile

1. Go to your team’s Repositories page
2. Click Manage Repos (or Enable Repositories if no repos are enabled yet)
3. Select the repos you want reviewed, then click Enable Repos (or use Enable All)

To automatically enable future repos, go to Code Review Settings and toggle Auto-enable New Repos.

Configure PR Summary

Customize how Greptile summarizes pull requests:

• PR Summary: Include a text summary of the changes
• Confidence Score: Show confidence levels for each PR
• Issue Table: Show important changed files with ratings
• Sequence Diagram: Add a diagram of the changes

Learn more about PR summaries →

Control Review Behavior

Fine-tune what Greptile comments on in Code Review Settings:

• Strictness Level: Adjust how often Greptile comments
• Auto-review on new commits: Review new commits after a PR is opened
• Review draft pull requests: Review drafts before they are marked ready
• File change limit: Set the largest PR Greptile reviews automatically

Learn more about controlling nitpickiness →

Add Filters

Set when Greptile comments in Code Review Settings under Greptile Comments:

• Labels: Only review PRs with specific labels (e.g., “needs-review”)
• Authors: Include/exclude specific developers or bots
• Branches: Target specific branches (e.g., main, develop)
• Keywords: Trigger on PR title/description keywords

Learn more about triggers →

Create a pull request

Wait for review (~3 minutes)

Greptile analyzes your PR with full codebase context and posts a comprehensive review.

Review the feedback

You’ll see a summary of changes, inline comments on issues, and suggested fixes.