@gitlab/duo-cli

GitLab Duo CLI (Beta)

[!note] Duo CLI npm package (@gitlab/duo-cli) is not under active development. Install the GitLab Duo CLI with glab duo cli or as a standalone binary instead.

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

📖 For installation, usage, and configuration see the GitLab Duo CLI documentation.

Development

To run the CLI from a local checkout:

bun run cli

This builds and launches the app. Pass CLI flags after --:

bun run cli -- run --goal "example"

For hot-reload development, use bun run dev:watch instead.

See the full Development Guide for prerequisites, building, debugging, testing, and architecture details.

Packages

The GitLab Duo CLI is split across two packages:

• packages/cli — CLI entry point, command routing, backend abstraction, and controllers for interactive and headless modes.
• packages/tui — React-based terminal UI built on Ink. Pure presentation layer with zero domain logic. Renders the chat interface, messages, tool calls, diffs, and Markdown.

License

See the License for details.