CLI based pipeline watcher
Find a file
2025-08-18 14:13:48 +02:00
src fix: refresh stdout every second 2025-08-18 14:13:48 +02:00
.gitignore chore: initial commit 2025-07-21 19:20:09 +02:00
.rustfmt.toml chore: initial commit 2025-07-21 19:20:09 +02:00
Cargo.lock chore: initial commit 2025-07-21 19:20:09 +02:00
Cargo.toml chore: initial commit 2025-07-21 19:20:09 +02:00
config.toml chore: initial commit 2025-07-21 19:20:09 +02:00
LICENSE chore: Add README and LICENSE 2025-07-21 19:20:13 +02:00
README.md chore: Add README and LICENSE 2025-07-21 19:20:13 +02:00

pipeponder

pipeponder is a terminal-based GitLab pipeline watcher tool written in Rust. It allows you to monitor the status of GitLab pipelines either by repository or by pipeline ID, and continuously refreshes the status in your terminal.


Features

  • Authenticate to GitLab using basic LDAP credentials.
  • Watch pipelines by repository and branch/ref.
  • Watch pipelines by specific pipeline ID.
  • Periodically refresh and display the pipeline statuses in the terminal.

Installation

Clone the repository and build the project:

git clone https://github.com/pkoscik/pipeponder.git
cd pipeponder
cargo build --release

Configuration

Create a .env file in the root directory with your GitLab credentials and server address:

GITLAB_USERNAME=your_username
GITLAB_PASSWORD=your_password
GITLAB_ADDRESS=https://gitlab.example.com

Modify the config.toml file to define which repositories or pipeline IDs to watch and set the refresh interval:

refresh_duration = 30  # json refresh interval in seconds

[[watch]]
repo = "group/repo"   # "repositories/repository1"
ref_field = "main"    # branch name
source = "push"       # one of: push, trigger, schedule

[[watch]]
id = 123456