@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

After installation, start the GitLab Duo CLI in interactive mode:

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.