@gitlab/duo-cli

GitLab Duo CLI (experimental)

GitLab Duo for your command line. An AI-powered CLI tool that brings GitLab Duo Chat (Agentic) to your terminal.

The GitLab Duo CLI can help you:

• Understand your codebase structure, cross-file functionality, and individual code snippets.
• Build, modify, refactor, and modernize code.
• Troubleshoot errors and fix code issues.
• Automate CI/CD configuration, troubleshoot pipeline errors, and optimize pipelines.
• Perform multi-step development tasks autonomously.

This tool is experimental and some features might not work as expected.

Installation

Prerequisites:

• Node.js 22 or later.
• A personal access token with api scope.

To install the GitLab Duo CLI globally, run:

npm install -g @gitlab/duo-cli

Alternative: Install using installation script

You can use the installation script to install the GitLab Duo CLI without Node.js:

macOS and Linux

bash <(curl -fsSL "https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.sh")

Windows

irm "https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.ps1" | iex

This script will:

• Detect your platform (OS and architecture)
• Download the appropriate GitLab Duo CLI binary
• Install it to ~/.local/bin/duo
• Update your PATH if needed

For non-interactive installation (useful for CI/CD):

curl -fsSL https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.sh | bash -s -- -y

To install a specific version:

curl -fsSL https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.sh | bash -s -- --version 1.2.3

After installation, you can run the GitLab Duo CLI using the duo command.

Updating

To update to the latest version:

npm install -g @gitlab/duo-cli@latest

Usage

Interactive Mode (TUI)

Start the interactive terminal UI:

duo

Alternatively, you can run the GitLab Duo CLI without installing:

npx -y @gitlab/duo-cli

To run a workflow in headless mode, use the command duo run:

[!warning] Headless mode bypasses manual tool approval. Use this mode with caution and in a controlled sandbox environment.

duo run --goal "Your goal or prompt here"

Documentation

For detailed setup, usage, troubleshooting, and configuration instructions, see the GitLab Duo CLI documentation.

Contributing

See Development Guide for information on contributing to this project.

License

See the License for details.