greptile.json Reference

Fresh

Complete greptile.json reference with all configuration parameters. Control review behavior, PR filters, file patterns, custom context, and output formatting.

Complete configuration reference for greptile.json. All parameters are optional.

Note

Looking for the recommended config format? The .greptile/ folder supports everything greptile.json does, plus cascading per-directory overrides, separate rules files, and structured rules with severity and disable-by-ID. greptile.json is still fully supported, if both exist in the same directory, .greptile/ takes precedence.

Note

Place greptile.json in your repository root. Settings are read from the source branch of the PR and override dashboard settings.

Review Behavior

Parameter	Type	Default	Description
`strictness`	number	`2`	Severity threshold. Must be `1`, `2`, or `3`
`commentTypes`	array	`["logic", "syntax", "style", "info"]`	Comment types to provide. Options: `logic`, `syntax`, `style`, `info`
`triggerOnUpdates`	boolean	`false`	Review every commit to the PR, not just when opened
`triggerOnDrafts`	boolean	`false`	If `true`, review draft PRs. Default is `false`
`skipReview`	string	-	Set to `"AUTOMATIC"` to skip auto-reviews but allow manual triggers

PR Filters

Control which PRs get reviewed:

Parameter	Type	Description
`labels`	array	Review only PRs with these labels. Supports glob patterns.
`disabledLabels`	array	Skip PRs with these labels. Supports glob patterns.
`includeAuthors`	array	Review only PRs from these authors. Empty = all authors (except excluded). Supports glob patterns.
`excludeAuthors`	array	Never review PRs from these authors. Supports glob patterns.
`includeBranches`	array	Review only PRs to these branches. Empty = all branches (except excluded). Supports glob patterns.
`excludeBranches`	array	Never review PRs to these branches. Supports glob patterns.
`includeKeywords`	string	Newline-separated keywords. Review only PRs with these in title/description
`ignoreKeywords`	string	Newline-separated keywords. Skip PRs with these in title/description
`fileChangeLimit`	number	Skip PRs with more than this many changed files (minimum: 1)

Glob patterns in filters

Label, author, and branch fields accept globs alongside literals. Matching is case-insensitive.

*, any chars in a segment
**, any chars across segments
?, one char
{a,b}, a or b
[, ], and leading ! are literal. dependabot[bot] works as-is. Negation is not supported.

json

{
  "includeBranches": ["main", "release/*"],
  "excludeBranches": ["dependabot/**"],
  "disabledLabels": ["wip-*"],
  "excludeAuthors": ["*-bot", "*@dependabot.com", "dependabot[bot]"]
}

File Patterns

Parameter	Type	Description
`ignorePatterns`	string	Newline-separated file patterns to skip (follows `.gitignore` syntax)

Example:

json

{
  "ignorePatterns": "**/*.generated.*\ndist/**\nnode_modules/**"
}

Cross-Repository Context

Configure related repositories Greptile should read during reviews (e.g., shared libraries or SDKs) under the context namespace.

Parameter	Type	Description
`context`	object	Namespace for context-related settings.
`context.repos`	array	Related repositories Greptile should read during reviews. Each entry must be in `owner/repo` format, on the same SCM host as the primary repository, and accessible with the same credentials.

Example:

json

{
  "context": {
    "repos": ["acme/shared-types", "acme/payment-sdk"]
  }
}

Custom Context

Parameter	Type	Description
`instructions`	string	Natural language instructions for code reviews
`customContext`	object	Advanced context with `rules`, `files`, and `other` arrays
`patternRepositories`	array	Related repos to reference (format: `org/repo`)

customContext structure:

json

{
  "customContext": {
    "rules": [
      {
        "rule": "Use async/await instead of callbacks",
        "scope": ["src/**/*.ts"]
      }
    ],
    "files": [
      {
        "path": "docs/style-guide.md",
        "description": "Company style guide",
        "scope": ["src/**"]
      }
    ],
    "other": [
      {
        "content": "This is a legacy codebase - be cautious with changes",
        "scope": ["legacy/**"]
      }
    ]
  }
}

Review Output

Control how reviews appear:

Parameter	Type	Description
`shouldUpdateDescription`	boolean	If `true`, updates PR description. If `false`, posts as review comment
`updateExistingSummaryComment`	boolean	Update existing review comment instead of creating new one
`updateSummaryOnly`	boolean	Only update summary, don't post individual inline comments
`fixWithAI`	boolean	Add AI fix prompts to help AI tools understand fixes
`hideFooter`	boolean	Hide Greptile footer from review comments

Review Components

Control visibility of individual review components:

Parameter	Type	Description
`includeIssuesTable`	boolean	Include issues table in review
`includeConfidenceScore`	boolean	Include confidence scores in review
`includeSequenceDiagram`	boolean	Include diagrams in review (sequence, ER, class, or flow, auto-selected based on changes)

Review Sections

Fine-grained control over section visibility and behavior:

Parameter	Type	Properties
`summarySection`	object	`included` (boolean), `collapsible` (boolean), `defaultOpen` (boolean)
`issuesTableSection`	object	`included` (boolean), `collapsible` (boolean), `defaultOpen` (boolean)
`confidenceScoreSection`	object	`included` (boolean), `collapsible` (boolean), `defaultOpen` (boolean)
`sequenceDiagramSection`	object	Controls the diagram section (sequence, ER, class, or flow). Properties: `included` (boolean), `collapsible` (boolean), `defaultOpen` (boolean)

Example:

json

{
  "summarySection": {
    "included": true,
    "collapsible": true,
    "defaultOpen": false
  }
}

GitHub-Specific

Parameter	Type	Description
`statusCheck`	boolean	Create a GitHub status check for each review. When enabled, Greptile posts a status check (pass/fail indicator) instead of a comment like "X files reviewed, no comments". Set to `true` to disable the "X files reviewed" comments.
`statusCommentsEnabled`	boolean	Post a summary comment on PRs after review. This controls the main review summary comment, not the "X files reviewed" status message.

Note

Common confusion: To disable the "X files reviewed, no comments" message, set statusCheck: true (not statusCommentsEnabled: false). When statusCheck is enabled, Greptile uses GitHub's status check system instead of posting status comments.

Complete Example

json

{
  "strictness": 2,
  "commentTypes": ["logic", "syntax"],
  "context": {
    "repos": ["acme/shared-types", "acme/payment-sdk"]
  },
  "instructions": "Focus on security and maintainability",
  "ignorePatterns": "**/*.generated.*\ndist/**\n*.md",
  "patternRepositories": ["acme/shared-utils"],
  "triggerOnUpdates": false,
  "fileChangeLimit": 100,
  "includeAuthors": [],
  "excludeAuthors": ["dependabot[bot]"],
  "includeBranches": ["main", "develop"],
  "excludeBranches": ["draft/**"],
  "customContext": {
    "rules": [
      {
        "rule": "All API endpoints must have rate limiting",
        "scope": ["src/api/**/*.ts"]
      }
    ],
    "files": [
      {
        "path": "docs/architecture.md",
        "description": "System architecture"
      }
    ]
  },
  "shouldUpdateDescription": false,
  "updateExistingSummaryComment": true,
  "statusCheck": true,
  "includeConfidenceScore": true,
  "summarySection": {
    "included": true,
    "collapsible": false,
    "defaultOpen": true
  }
}

Parameter Reference by Category

All parameters alphabetically

* `commentTypes` - array
* `context` - object (with `repos` array)
* `customContext` - object
* `disabledLabels` - array
* `excludeAuthors` - array
* `excludeBranches` - array
* `fileChangeLimit` - number
* `fixWithAI` - boolean
* `hideFooter` - boolean
* `ignoreKeywords` - string
* `ignorePatterns` - string
* `includeAuthors` - array
* `includeBranches` - array
* `includeConfidenceScore` - boolean
* `includeIssuesTable` - boolean
* `includeKeywords` - string
* `includeSequenceDiagram` - boolean (controls all diagram types)
* `instructions` - string
* `labels` - array
* `patternRepositories` - array
* `shouldUpdateDescription` - boolean
* `skipReview` - string (literal `"AUTOMATIC"`)
* `statusCheck` - boolean
* `statusCommentsEnabled` - boolean
* `strictness` - number (1, 2, or 3)
* `triggerOnDrafts` - boolean
* `triggerOnUpdates` - boolean
* `updateExistingSummaryComment` - boolean
* `updateSummaryOnly` - boolean
* **Section objects:** `summarySection`, `issuesTableSection`, `confidenceScoreSection`, `sequenceDiagramSection`

Validation

JSON syntax errors

**Common mistakes:**

❌ **Trailing commas:**

```json theme={}
{
  "strictness": 2,
  "commentTypes": ["logic"],
}
```

✅ **No trailing comma:**

```json theme={}
{
  "strictness": 2,
  "commentTypes": ["logic"]
}
```

**Validate your JSON:**

```bash theme={}
npx jsonlint greptile.json
```

Invalid parameter values

**strictness must be 1, 2, or 3:**

```json theme={}
{
  "strictness": 4
}
```

❌ Invalid - only 1, 2, or 3 allowed

**commentTypes must be valid:**

```json theme={}
{
  "commentTypes": ["logic", "syntax", "style", "info"]
}
```

✅ Valid options: `logic`, `syntax`, `style`, `info`

**skipReview must be exactly "AUTOMATIC":**

```json theme={}
{
  "skipReview": "AUTO"
}
```

❌ Invalid - must be `"AUTOMATIC"` exactly

File location

**✅ Correct:** Repository root

```
your-repo/
├── greptile.json
├── src/
└── package.json
```

**❌ Wrong:** Subdirectory

```
your-repo/
├── src/
│   └── greptile.json
└── package.json
```

Configuration not taking effect

**Check:**

1. File is in repository root
2. File exists in the source branch of the PR
3. JSON is valid (use jsonlint)
4. Parameter names are spelled correctly
5. Waiting for new PR (changes don't affect existing reviews)

Tip

  Export dashboard settings: Go to app.greptile.com/review/github → Click copy/download icon

Configuration Hierarchy

Settings priority (highest to lowest):

Org enforced rules (set by admins in the dashboard, cannot be overridden)
.greptile/ folder (per-directory and repo-wide settings)
greptile.json in repository root
Dashboard settings (organization defaults)

If both .greptile/ and greptile.json exist in the same directory, .greptile/ takes precedence and greptile.json is ignored. See Customization Overview for details.

What's Next

Custom Standards → - Enforce team-specific rules
Pattern Repositories → - Reference related codebases
Controlling Nitpickiness → - Fine-tune review behavior

Source

Mirrored from the official Greptile documentation. Self-contained reference copy.

greptile.json Reference ​

Review Behavior ​

PR Filters ​

Glob patterns in filters ​

File Patterns ​

Cross-Repository Context ​

Custom Context ​

Review Output ​

Review Components ​

Review Sections ​

GitHub-Specific ​

Complete Example ​

Parameter Reference by Category ​

All parameters alphabetically ​

Validation ​

JSON syntax errors ​

Invalid parameter values ​

File location ​

Configuration not taking effect ​

Configuration Hierarchy ​

What's Next ​

greptile.json Reference

Review Behavior

PR Filters

Glob patterns in filters

File Patterns

Cross-Repository Context

Custom Context

Review Output

Review Components

Review Sections

GitHub-Specific

Complete Example

Parameter Reference by Category

All parameters alphabetically

Validation

JSON syntax errors

Invalid parameter values

File location

Configuration not taking effect

Configuration Hierarchy

What's Next