Skip to main content
Use Greptile in Codex to read pull request reviews and review your local branch. The plugin includes Greptile MCP and a bundled CLI. Both use OAuth; no API key or separate CLI installation is required.
Prerequisites: Install Codex, git, and Node 22+. Create a Greptile account and connect your repositories.

​
Installation

1

Add the Greptile marketplace

2

Install the Greptile plugin

The plugin includes Greptile MCP and the login and review skills. Start a new Codex task after installation.
3

Connect Greptile MCP

Connect the Greptile MCP server supplied by the plugin in Codex. Complete the browser sign-in at auth.greptile.com.Codex manages the MCP credentials. Verify access with:
4

Sign in to the bundled CLI

For local branch reviews, ask Codex:
Complete the browser sign-in. The CLI stores its credentials in ~/.greptile/auth.json. MCP and CLI sign-ins are separate; sign in to each surface you use.
5

Verify the installation

Confirm the greptile-plugin marketplace and the enabled greptile plugin are listed. Open a Git repository with committed changes and ask:

​
Update or migrate

To update the current plugin:
If you installed the former greptile-codex-plugins marketplace, remove that plugin and marketplace first:
Then follow the installation steps above. Start a new Codex task and confirm the plugin exposes login and review. The old check-pr, cli-review, and greploop skills are not part of this plugin.

​
Workflows

No open pull request is needed for a local review. The result is saved to your Greptile account; MCP can read it back separately.

​
The bundled CLI

The CLI ships with the plugin and updates with it. greptile update, npm, and Homebrew do not update this copy. A separately installed CLI is not used by the plugin’s skills, though both share the CLI login on this machine.

​
Troubleshooting

Run the update commands above and start a new Codex task. Ask for the Greptile plugin’s login or review skill by name.
Reconnect the Greptile MCP server supplied by the plugin in Codex and complete browser sign-in. The server URL is https://api.greptile.com/mcp. Signing in to the CLI does not authenticate MCP.
Confirm Node 22+ is available with node --version. Use the plugin’s login skill if the CLI reports that you are signed out. Run the review from a Git repository with committed changes.

​
Next steps

MCP setup

Configure Greptile MCP in other coding tools.

Greptile CLI

Learn about the standalone CLI and local reviews.

Codex plugin source

Read the marketplace package, skills, and setup instructions.