gitlab-awesome-cli

glcli

  ██████╗ ██╗      ██████╗██╗     ██╗
 ██╔════╝ ██║     ██╔════╝██║     ██║
 ██║  ███╗██║     ██║     ██║     ██║
 ██║   ██║██║     ██║     ██║     ██║
 ╚██████╔╝███████╗╚██████╗███████╗██║
  ╚═════╝ ╚══════╝ ╚═════╝╚══════╝╚═╝

An interactive terminal UI for GitLab — like k9s, but for pipelines.

Monitor pipelines across all your projects, stream job logs, retry failures, and manage CI/CD without ever opening a browser tab.

Preview

┌─────────────────────────────────────────────────────────────────────────────┐
│  glcli  [1] Projects  [2] Pipelines  [3] Jobs  [4] Log          ↻ 5s  l:50 │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  PIPELINES  (47 total)  /filter                                             │
│                                                                             │
│  PROJECT                  BRANCH          STATUS     DURATION   STARTED     │
│  ──────────────────────── ─────────────── ────────── ────────── ─────────── │
│  group/backend            main            ● running  2m 14s     just now    │
│  group/frontend           feat/auth       ✓ success  4m 33s     3 min ago   │
│  group/api-gateway        main            ✓ success  1m 58s     7 min ago   │
│  group/worker             fix/memory-leak ✗ failed   3m 01s     12 min ago  │
│  group/infra              main            ● running  0m 44s     just now    │
│  group/backend            feat/payments   ⏸ manual   —          15 min ago  │
│                                                                             │
│                                                                             │
├─────────────────────────────────────────────────────────────────────────────┤
│  j/k navigate  enter select  r retry  c cancel  / filter  q quit           │
└─────────────────────────────────────────────────────────────────────────────┘

Features

• Multi-view TUI — Projects, Pipelines, Jobs, and Log tabs in a single terminal window
• All pipelines at a glance — aggregates pipelines from all configured projects on one screen
• Live auto-refresh — configurable polling interval with a visible countdown
• Job log streaming — tail logs in real time with viewport scrolling
• Pipeline actions — run manual jobs, retry failed, cancel running — all with a confirmation dialog
• Fuzzy filter — press / to filter pipelines by project name, branch, or status
• Pipeline limit control — press l to cycle the fetch limit: 20 → 50 → 100 → 200
• Add/remove projects — interactive autocomplete search against the GitLab API
• Vim-style navigation — j/k, g/G, Ctrl+u/Ctrl+d
• Russian keyboard layout support — keys work regardless of active layout
• Clean config — single YAML file at ~/.glcli.yaml
• MCP Server — let AI assistants (Claude Code, etc.) interact with your GitLab via Model Context Protocol

Install

go install

go install github.com/bearlogin/gitlab-awesome-cli/cmd/glcli@latest

Homebrew (coming soon)

brew install bearlogin/tap/glcli

Pre-built binaries

Download the latest binary for your platform from the Releases page.

# Linux amd64
curl -Lo glcli https://github.com/bearlogin/gitlab-awesome-cli/releases/latest/download/glcli_linux_amd64
chmod +x glcli
sudo mv glcli /usr/local/bin/

# macOS arm64 (Apple Silicon)
curl -Lo glcli https://github.com/bearlogin/gitlab-awesome-cli/releases/latest/download/glcli_darwin_arm64
chmod +x glcli
sudo mv glcli /usr/local/bin/

Quick Start

Run glcli for the first time and the setup wizard will guide you through initial configuration:

$ glcli

GitLab URL (e.g. https://gitlab.example.com): https://gitlab.mycompany.com
Personal Access Token: glpat-xxxxxxxxxxxxxxxxxxxx
Projects (comma-separated, e.g. group/project1,group/project2): mygroup/api,mygroup/frontend

Config saved to ~/.glcli.yaml

You need a GitLab Personal Access Token with read_api scope (add write_repository if you want to trigger/retry/cancel pipelines).

Configuration

Config lives at ~/.glcli.yaml:

gitlab_url: https://gitlab.example.com
token: glpat-xxxxxxxxxxxxxxxxxxxx
projects:
  - group/backend
  - group/frontend
  - group/infra
refresh_interval: 5s
pipeline_limit: 50

Keybindings

Global

Navigation

Pipelines view

Jobs view

Projects view

Log view

MCP Server (AI Integration)

glcli ships with a built-in MCP server — a separate binary that lets AI assistants work with your GitLab directly from the terminal.

Install

make build-mcp
# or
go install github.com/bearlogin/gitlab-awesome-cli/cmd/glcli-mcp@latest

Register in Claude Code

Add to .claude/settings.json (project-level) or ~/.claude/settings.json (global):

{
  "mcpServers": {
    "glcli": {
      "command": "glcli-mcp"
    }
  }
}

Available Tools

Resources

Usage Examples

Once registered, just ask your AI assistant in natural language:

> Show me failed pipelines
> What's the log of the latest failed job in mygroup/api?
> Retry that job
> List all running pipelines on main branch

Building from Source

Requirements: Go 1.21+

git clone https://github.com/bearlogin/gitlab-awesome-cli.git
cd gitlab-awesome-cli
make build        # TUI binary → dist/glcli
make build-mcp    # MCP server binary → dist/glcli-mcp
make build-all    # both

Other Makefile targets:

make run          # go run (TUI)
make test         # run tests
make lint         # run golangci-lint
make vet          # go vet
make install      # install glcli to $GOPATH/bin or /usr/local/bin
make install-mcp  # install glcli-mcp
make clean        # remove dist/

Architecture

cmd/
  glcli/                — TUI entry point
  glcli-mcp/            — MCP server entry point
internal/
  domain/               — entities, value objects, repository interfaces
  application/service/  — use-case orchestration
  infrastructure/
    gitlab/             — GitLab API client (go-gitlab)
    config/             — YAML config loading + setup wizard
  presentation/
    tui/                — terminal UI
      views/            — Projects, Pipelines, Jobs, Log screens
      components/       — shared widgets (statusbar, breadcrumb, confirm dialog)
      styles/           — lipgloss theme
      keymap/           — key normalization incl. Russian layout
    mcp/                — MCP server (tools, resources, formatters)

License

MIT — Copyright (c) 2026 bearlogin