.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-duo-cli - Run the GitLab Duo CLI.


.SH SYNOPSIS
\fBglab duo cli [command] [flags]\fP


.SH DESCRIPTION
Run the GitLab Duo CLI (\fBduo\fR) through \fBglab\fR\&.

.PP
The GitLab Duo CLI brings the GitLab Duo Agent Platform to your terminal. Ask GitLab Duo questions about your codebase and use it to autonomously perform actions on your behalf.

.PP
The GitLab Duo CLI runs in two modes:
.IP \(bu 2
Interactive (default): \fBglab duo cli\fR opens a session for multiple prompts, with build and plan modes.
.IP \(bu 2
Headless: \fBglab duo cli run --goal "<prompt>"\fR runs a single prompt and exits. For use in runners, scripts, and automated workflows.

.PP
When you use the GitLab Duo CLI through \fBglab\fR, \fBglab\fR handles authentication for you. You authenticate only once.

.PP
Prerequisites:
.IP \(bu 2
Use GitLab 19.2 or later.
.IP \(bu 2
Run \fBglab auth login\fR to authenticate.
.IP \(bu 2
Meet the prerequisites for GitLab Duo Agent Platform
\[la]https://docs.gitlab.com/user/duo_agent_platform/#prerequisites\[ra]\&.
.IP \(bu 2
Set a default GitLab Duo namespace
\[la]https://docs.gitlab.com/user/profile/preferences/#namespace\-resolution\-in\-your\-local\-environment\[ra], or run the command in a project that has GitLab Duo access.
.IP \(bu 2
For GitLab Self-Managed and GitLab Dedicated on 19.2 or later, turn on GitLab Duo CLI access
\[la]https://docs.gitlab.com/user/gitlab_duo_cli/#turn\-gitlab\-duo\-cli\-access\-on\-or\-off\[ra]\&. It is on by default.

.PP
If you are on GitLab 18.11 to 19.1, you can use the GitLab Duo CLI by turning on beta and experimental features
\[la]https://docs.gitlab.com/user/duo_agent_platform/turn_on_off/#turn\-on\-beta\-and\-experimental\-features\[ra]\&.

.PP
Configuration options:
.IP \(bu 2
\fBduo_cli_auto_run\fR: Skip the run confirmation prompt.
.IP \(bu 2
\fBduo_cli_auto_download\fR: Skip the download confirmation prompt.

.PP
\fBglab\fR passes all other arguments and flags through to the GitLab Duo CLI binary. To see the GitLab Duo CLI commands and flags, run \fBglab duo cli help\fR\&.

.PP
For more information, see the GitLab Duo CLI documentation
\[la]https://docs.gitlab.com/user/gitlab_duo_cli/\[ra]\&.


.SH OPTIONS
\fB--install\fP[=false]
	Install the GitLab Duo CLI binary without running it.

.PP
\fB--update\fP[=false]
	Check for and install updates to the binary.

.PP
\fB-y\fP, \fB--yes\fP[=false]
	Skip confirmation prompts.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.


.SH EXAMPLE
.EX
# Start an interactive GitLab Duo CLI session
glab duo cli

# Use the GitLab Duo CLI in headless mode with a single prompt
glab duo cli run --goal "Fix the failing tests in this project"

# Pass any command or flag through to the GitLab Duo CLI binary (for example: model, version, run)
glab duo cli <command>
glab duo cli --model claude_sonnet_4_6

# Show GitLab CLI help content
glab duo cli --help

# Show GitLab Duo CLI help content, including commands and flags
glab duo cli help

# Run without prompts (for use in scripts and non-interactive environments)
glab duo cli --yes

# Install the GitLab Duo CLI binary
glab duo cli --install

# Install the GitLab Duo CLI binary without prompts
glab duo cli --install --yes

# Check for and install updates
glab duo cli --update
.EE


.SH SEE ALSO
\fBglab-duo(1)\fP