> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gitar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Commands & Interactions

> Control Gitar's behavior through PR comments and commands

export const ThemeImage = ({src, alt}) => {
  let lightSrc, darkSrc;
  if (src.includes("-light.")) {
    lightSrc = src;
    darkSrc = src.replace("-light.", "-dark.");
  } else if (src.includes("-dark.")) {
    darkSrc = src;
    lightSrc = src.replace("-dark.", "-light.");
  } else {
    lightSrc = src;
    darkSrc = src;
  }
  return <span>
      <img className="block dark:hidden rounded-lg border" src={lightSrc} alt={alt} />
      <img className="hidden dark:block rounded-lg border" src={darkSrc} alt={alt} />
    </span>;
};

## 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.

| Command         | Syntax                  |
| --------------- | ----------------------- |
| Unblock         | `gitar unblock`         |
| Auto-apply on   | `gitar auto-apply:on`   |
| Auto-apply off  | `gitar auto-apply:off`  |
| Display verbose | `gitar display:verbose` |
| Display compact | `gitar display:compact` |

***

### Unblock

Dismiss Gitar's blocking review so you can merge immediately. See [Block Merge](/features/code-review/block-merge) for details on how merge blocking works.

| Command         | Description                                       |
| --------------- | ------------------------------------------------- |
| `gitar unblock` | Dismiss Gitar's blocking review and allow merging |

<ThemeImage src="/assets/images/gitar-unblock-light.png" alt="gitar unblock command dismissing a blocking review" border={true} />

<Note>
  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.
</Note>

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.

| Command                | Description                             |
| ---------------------- | --------------------------------------- |
| `gitar auto-apply:on`  | Enable automatic fix application        |
| `gitar auto-apply:off` | Disable 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.

<ThemeImage src="/assets/images/auto-apply-setting-light.png" alt="Auto-apply status in dashboard comment" border={true} />

<ThemeImage src="/assets/images/auto-apply-command-light.png" alt="Using gitar auto-apply command" border={true} />

***

### Display Mode

Control how much detail you see in the Gitar dashboard comment. The default is `compact` mode.

| Command                 | Description                                                        |
| ----------------------- | ------------------------------------------------------------------ |
| `gitar display:verbose` | Show all rules including those that don't apply, with explanations |
| `gitar display:compact` | Show 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:

<ThemeImage src="/assets/images/display-compact-light.png" alt="Compact display mode" border={true} />

**Verbose mode** shows all rules with explanations for why each rule doesn't apply:

<ThemeImage src="/assets/images/display-verbose-light.png" alt="Verbose display mode" border={true} />