qodev-gitlab-cli

Agent-friendly CLI for the GitLab API. Designed for both human and AI-agent workflows, with structured JSON output, consistent flags, and predictable error codes.

Why this CLI?

• Agent-friendly — --json on every command, consistent flags, predictable exit codes
• Built for AI agent workflows — works seamlessly with Claude Code, scripts, and automation pipelines
• How it compares: glab is GitLab's official interactive CLI for humans; qodev-gitlab is optimized for programmatic and agent use

Installation

pip install qodev-gitlab-cli

Or run directly without installing:

uvx qodev-gitlab-cli

Quick Start

# Set your GitLab token
export GITLAB_TOKEN="glpat-xxxxxxxxxxxxxxxxxxxx"

# Install AI agent skill files (for Claude Code, etc.)
$ qodev-gitlab-cli install --skills

# List open merge requests
$ qodev-gitlab-cli mrs list
!42  Add authentication  opened  feature/auth → main

# Get MR details as JSON (for scripts/agents)
$ qodev-gitlab-cli mrs get 42 --json
{"iid": 42, "title": "Add authentication", "state": "opened", ...}

# List pipelines
$ qodev-gitlab-cli pipelines list
12345  running  main  2m ago

# Get details of a specific issue
$ qodev-gitlab-cli issues get 42

# Create a merge request from the current branch
$ qodev-gitlab-cli mrs create --title "Add new feature"

Commands

Configuration

Authentication

Set the GITLAB_TOKEN environment variable, or pass --token on each invocation:

export GITLAB_TOKEN="glpat-xxxxxxxxxxxxxxxxxxxx"

GitLab Instance

By default the CLI targets https://gitlab.com. Override with the GITLAB_URL environment variable or the --url flag:

export GITLAB_URL="https://gitlab.example.com"

Global Options

Exit Codes

License

MIT -- see LICENSE for details.