Skip to content
github-actions[bot] edited this page Jul 4, 2026 · 3 revisions

gitlab-reviewer wiki

gitlab-reviewer reviews GitLab merge requests with Claude, from a terminal UI or a local browser GUI: it checks the MR branch out locally, runs focused review agents with full repository context, and lets you curate every suggested comment before anything is published back to the MR.

This wiki is the long-form documentation: usage guides with examples and a complete reference for every configuration setting. For a quick overview and installation, start with the README.

Guides

Page What it covers
Getting Started Install, token setup, your first review end to end
TUI Guide Every screen and keybinding: browsing, reviewing, curating, chat, approvals
GUI Guide The browser frontend: launching, screens, shortcuts, its security model
Headless Mode gitlab-reviewer review: non-interactive reviews for CI jobs and scripting
Review Agents Built-in reviewers, per-scan selection, cost control, writing your own agents
MCP Servers Granting the review session live reference material, safely
Checkout Modes Managed clones vs your own, the cache, worktrees, local overlays
Publishing Draft vs immediate, auto-publish, note fallback, comment templates
Security Model The review sandbox, token handling, and the GUI's session security
Recipes Worked configurations: multi-instance, Bedrock, monorepos, team agents, MR hygiene
Troubleshooting Common errors and how to read the logs

Reference

Page What it covers
Configuration Reference Every key, environment variable, flag, default, and validation rule
CLI Reference All commands: the TUI, gui, review, config, cache, version

Design documentation

Architecture diagrams, the TUI/GUI feature matrix, and the ADRs behind the big decisions live in the repository itself: docs/architecture.md, docs/features.md, docs/adr/.

Clone this wiki locally