glim

glim

A terminal user interface (TUI) for monitoring GitLab CI/CD pipelines and projects. Built with ratatui.

Prerequisites

• a terminal emulator with support for 24-bit color, e.g. kitty
• a GitLab personal access token (PAT) with read_api scope
• libssl-dev installed on your system

Building

cargo build --release 

Installation

cargo install glim-tui

Arch Linux

pacman -S glim

Running

To use glim, you'll need a GitLab personal access token (PAT) for authentication with the GitLab API. Be aware that this PAT is stored in plain text within the configuration file. If you start glim without any arguments and it hasn't been set up yet, the program will prompt you to enter the PAT and the GitLab server URL.

$ glim -h
A TUI for monitoring GitLab CI/CD pipelines and projects

Usage: glim [OPTIONS]

Options:
  -c, --config <FILE>      Alternate path to the configuration file
  -p, --print-config-path  Print the path to the configuration file and exit
  -h, --help               Print help
  -V, --version            Print version

Multiple GitLab servers

There is currently no support for multiple GitLab servers in the configuration file. The interim solution is to use the --config flag to specify a different configuration file, e.g. glim --config glim-corporate.toml or glim --config glim-personal.toml.