Skip to main content
Open a pull request in the Greptile dashboard. Choose a guided walkthrough or browse the changes by file. Use Chat with PR to ask questions as you review.

Choose a review view

Open the Code tab. When Tour is available, switch between Tour and Full diff above the code view. If there is no Tour, use Full diff.
Switch between Tour and Full diff above the code view.
Switch between Tour and Full diff above the code view.

Tour

Use Tour to understand the changes step by step. Each step groups related changes and explains the code beside it. Press Left or Right to move between steps.

Full diff

Use Full diff to inspect a specific file or review the changes in file order. Choose a file in the tree to view its diff.

Chat with PR

Click Chat with PR in the pull request header, or press Shift+C. Type a question about the PR in the chat box.
Open Chat with PR from the pull request header.
Open Chat with PR from the pull request header.

Choose context for your question

Give chat the code or explanation you want to discuss:
  1. Click Select context in the chat box. To use Shift+S, move focus out of the question box first.
  2. Click a review explanation or file header to add it. To select code, drag across the lines. A blue outline marks your selections.
  3. Type your question and send it.
Sending your question ends selection mode. You can also leave it with Done or Escape. Check the answer against the code before acting on it.
Choose Select context in the chat composer or press Shift+S.
Select context adds code or review content to your question.

Questions to try

  • What does this PR change?
  • Explain the changes in this context.
  • What edge cases should I test for this change?

Act on the PR from chat

Greptile can turn an answer into an action on the PR. Chat actions currently support GitHub pull requests. Proposed actions appear under the answer. When chat asks before running one:
  1. Read the proposal. Edit the text first if you want changes.
  2. Click Approve to run it, or Cancel to discard it. On routine actions like comments and replies, the approval menu also offers Allow for this chat — that kind of action runs without asking for the rest of the chat.
Actions run as you, so most need your GitHub account connected. Actions include posting or replying to comments, resolving or reopening threads, requesting a new review, approving or requesting changes, updating the PR description or branch, merging, closing, or reopening the PR, and turning the answer into a repository rule for future reviews.

Action permissions

Click the shield chip next to the send button to choose how much chat can run without asking:
  • Ask every time — chat waits for your approval on each action.
  • Allow routine actions — comments, replies, thread changes, and review requests run without asking.
  • Full access mode — every action runs without asking, including merges and deletions.
Permissions apply only to the current chat. New chats ask again. Requests to draft or preview an action stay unpublished in every mode. Eligible actions already waiting may run immediately when you raise the limit.

Keyboard shortcuts

Click the keyboard icon in the top bar to open Keyboard Shortcuts. Shortcuts depend on the current view and focus. The chat shortcuts do not run while the question box is focused.
The Keyboard Shortcuts menu groups navigation, view, selection, and review actions.
The Keyboard Shortcuts menu groups navigation, view, selection, and review actions.

Selection

These shortcuts select PRs in the list, separate from the code you select for chat.

Review actions

Actions depend on the PR state and your permissions.
When PRs are selected in the list, G, A, M, C, O, X, U, and F act on those PRs instead of the open PR. Clear the selection before using these keys on the open PR.D does not change draft status while PRs are selected.