Skip to main content
Click the Settings icon on the dashboard to customize how Gitar operates across your organization.

​
Configuration Scopes

Settings are configured at two levels:
  • Organization level — sets the defaults for every repository connected to Gitar.
  • Repository level — overrides specific org defaults for a single repo.
The org view is where you set defaults for behavior controls such as skip draft PRs, merge blocking, auto-approve, and auto-merge. When a repository needs different behavior, open its overrides dialog from the repository list. The dialog highlights which settings differ from the org default and lets you reset any override in one click.
Repository overrides only change settings that are explicitly toggled. Everything else inherits from the org default.

​
Behavior

​
Skip drafts

When enabled, Gitar ignores draft PRs until they are marked ready for review.

​
Enhance summaries

When enabled, Gitar auto-fills PR descriptions with a summary of the changes.

​
Retry unrelated CI failures

Automatically retry CI jobs whose failures are unrelated to the changes in your PR — for example, flaky tests or transient infrastructure issues. Retries once per commit.

​
Block merges

Configure a severity threshold for Gitar’s code review verdict. When findings meet or exceed the threshold, Gitar submits a blocking review to prevent merging.

​
gitar unblock

Enable the gitar unblock toggle to allow PR authors to dismiss Gitar’s blocking review by commenting gitar unblock.

​
Auto-approve

Enable Auto-approve PRs based on code review to let Gitar submit an approving review when a PR passes code review. You can optionally provide natural-language criteria to restrict which PRs qualify. When no criteria are configured, Gitar approves any PR with no blocking findings. See Auto-Approve for criteria examples, per-repo config files, and platform behavior.

​
gitar-approved label

Enable Apply gitar-approved label in the auto-approve settings to have Gitar add a gitar-approved label to approved PRs. The label is created automatically in the repository if it does not exist, making approved changes easy to filter in your platform’s PR list.

​
Auto-merge

Enable Auto-merge PRs after auto-approve to arm your platform’s native auto-merge immediately after Gitar approves. On GitHub you can choose the merge method (squash, merge commit, or rebase). On GitLab the project’s default merge method is used. See Auto-Merge for prerequisites and details.

​
Custom Instructions

Provide organization-wide instructions that guide the Gitar agent across all connected repositories. These are applied to every repo in your org. Use them to enforce coding standards, preferred libraries, or architectural patterns. Gitar also picks up repo-level instruction files such as AGENTS.md, CLAUDE.md, and .cursorrules — see Repository Configuration for details.

​
Scope

Control which PRs Gitar processes. All three fields accept comma-separated usernames.
  • Allowed authors — Only process PRs from these users. Leave empty to process all users.
  • Excluded authors — Skip PRs from these users, even if they match the allowed list.
  • Allowed bots — Bot accounts Gitar should process. By default all bot-authored changes are skipped. Add bots like Dependabot or Renovate here to include them.

​
Skipping PRs with gitar-skip

Add the gitar-skip label to any PR to skip all Gitar processing for that change. This works regardless of other scope settings and is useful for one-off exclusions without changing your org or repo configuration.