Skip to main content

​
Interacting with Gitar

You can interact with Gitar in PR and MR comments. Start your comment with gitar or @gitar (case-insensitive), mention @gitar-bot anywhere in the comment (GitHub), or reply directly to one of Gitar’s comments or inline findings (no prefix needed). On GitLab, you can also mention your custom service account (e.g. @gitar-service-yourorg). Gitar understands natural language — ask it to fix something, make changes, or answer questions:
  • gitar fix this or reply fix on an inline finding
  • gitar please add a unit test for this
  • gitar why was this file changed?
  • gitar create a Jira ticket for this
Gitar reacts with eyes when it starts processing and thumbs-up when it completes an integration request.

​
Commands

Commands are exact phrases that control Gitar’s behavior on a specific PR. Unlike free-form comments, commands must match exactly (case-insensitive). Gitar reacts with a thumbs-up when a command is processed. You can include multiple commands in a single comment on separate lines — last one wins if they conflict.
CommandSyntax
Unblockgitar unblock
Auto-apply ongitar auto-apply:on
Auto-apply offgitar auto-apply:off
Display verbosegitar display:verbose
Display compactgitar display:compact

​
Unblock

Dismiss Gitar’s blocking review so you can merge immediately. See Block Merge for details on how merge blocking works.
CommandDescription
gitar unblockDismiss Gitar’s blocking review and allow merging
The gitar unblock command must be enabled by an org admin in Settings > Behavior. The hint in review comments only appears when Gitar is actually blocking the PR.
Trailing punctuation is accepted — gitar unblock. and gitar unblock! both work.

​
Auto-Apply

Control whether Gitar automatically commits fixes to your branch for code review findings and CI failures.
CommandDescription
gitar auto-apply:onEnable automatic fix application
gitar auto-apply:offDisable automatic fixes (analysis only)
Your preference persists across comment updates for the life of the PR. The dashboard comment displays the current auto-apply status.

​
Display Mode

Control how much detail you see in the Gitar dashboard comment. The default is compact mode.
CommandDescription
gitar display:verboseShow all rules including those that don’t apply, with explanations
gitar display:compactShow only relevant rules (default)
Your display preference persists across comment updates. The footer shows a hint for the opposite command. Compact mode (default) shows only applicable rules with a summary of how many were hidden: Verbose mode shows all rules with explanations for why each rule doesn’t apply: