Greptile Docs

Appearance

Customization Overview ​

Fresh

Three ways to customize Greptile, .greptile/ folders, greptile.json, and the Dashboard UI

Greptile gives you three ways to customize review behavior. Pick the one that fits how your team works, or combine them.

Configuration Methods ​

A folder you place in any directory of your repo. Supports cascading, root-level defaults with per-directory overrides.

* Version controlled and reviewed in PRs
* Separate files for settings, rules, and context
* Per-directory overrides for monorepos
* Structured rules with scoping, severity, and disable-by-ID

greptile.json ​

A single JSON file in your repository root. Everything in one file, settings, rules, and context.

* Version controlled and reviewed in PRs
* Repository-wide settings only (no per-directory overrides)
* Good for simpler repos that don't need cascading

Dashboard UI ​

Organization-wide defaults at app.greptile.com.

* Changes apply immediately, no commits needed
* Affects all repositories in the organization
* Good for quick experiments and org-wide defaults

How They Interact ​

When multiple methods are used, settings are resolved in this order (highest priority first):

  1. Org enforced rules, set by admins in the dashboard, cannot be overridden
  2. .greptile/ folder, per-directory and repo-wide settings
  3. greptile.json, repo-wide settings (ignored if .greptile/ exists in the same directory)
  4. Org default rules, dashboard defaults, overridden by any repo-level config

Note

If both .greptile/ and greptile.json exist in the repository root, .greptile/ takes precedence and greptile.json is ignored.

In This Section ​

.greptile/ Configuration ​

How cascading works, merge rules, monorepo examples

.greptile/ File Reference ​

Complete schema for config.json, rules.md, and files.json

Controlling Nitpickiness ​

Adjust strictness, filter comment types, ignore files

Training the Learning System ​

Use reactions and feedback to improve reviews

Custom Standards ​

Enforce team-specific coding rules

Pattern Repositories ​

Reference related codebases

greptile.json Reference ​

Legacy format, complete parameter documentation

Source

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