Skip to main content
Use the Greptile CLI to run local code reviews from your terminal. This page covers Greptile CLI v3.0.1. Review your current branch against its base branch, resume unfinished reviews, and reopen past reviews without leaving your shell.

​
Install

Install the CLI:
Check that the command works:

​
Prerequisites

​
Sign in

Authenticate once on each device:
For CI or self-hosted deployments, use an API key instead of browser sign-in:
On a self-hosted deployment, first point the CLI at it: greptile settings set apiBaseUrl <origin>. See CLI Reviews on Self-Hosted Greptile. Check the signed-in account and org membership:
To sign out:

​
Review a branch

Checkout to the branch you’re working in and run a review from the repository root:
By default, Greptile compares your current branch against the repository’s default branch, usually main, and reviews the unmerged commits on the current branch. Uncommitted changes are ignored. Set the base branch explicitly and Greptile will compare current branch with this branch and review the unmerged commits:
Resume the latest unfinished review:
Show findings inline with the relevant code:
Greptile CLI review running in a terminal Increase the surrounding code shown with inline findings (default: 15):

​
Output formats

Use JSON when another tool needs to parse the review:
Use plain text for agent workflows or scripts:
--agent is an alias for --text. Plain text is also used automatically when output is piped.

​
Reopen a past review

Open a recent review picker:
Open a review by ID:

​
Command reference

​
Review options

​
Next

MCP

Use Greptile review data from your editor or coding agent.