Package Exports

glab-tui
glab-tui/glab-tui

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (glab-tui) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

glab-tui 🚀

A beautiful, interactive Terminal User Interface (TUI) for GitLab CI/CD pipelines.

Stop typing repetitive glab commands - see everything at once in a visual dashboard! ✨

⚡ Quick Start

# The easy way
npx glab-tui

# Or download and run
curl -L https://github.com/rkristelijn/glab-tui/releases/latest/download/glab-tui-linux-amd64 -o glab-tui
chmod +x glab-tui
./glab-tui

🎯 Why glab-tui?

Before (CLI):

glab pipeline list          # Check pipelines
glab pipeline ci view 123   # Check specific pipeline  
glab api jobs/456/trace     # Get job logs
# Repeat every 30 seconds... 😴

After (TUI):

glab-tui                    # See everything at once! 🎉

✨ Features

🔄 Real-time monitoring - Live pipeline status updates
🔥 Real-time log streaming - Stream job logs as they happen with --follow ✅ CONFIRMED WORKING
🎨 Beautiful interface - Color-coded status indicators and visual formatting
📊 Visual overview - Multiple pipelines at a glance in one screen
⌨️ Keyboard driven - Vim-style navigation (hjkl) for quick browsing
🎯 Interactive dashboard - Navigate through pipelines, jobs, and details
🔍 Better UX - No more repetitive CLI commands for status checks
🚀 Easy setup - Uses your existing glab authentication

🎮 Usage

Interactive TUI (Default)

./glab-tui                  # Start the beautiful TUI

CLI Commands

./glab-tui pipelines        # List pipelines
./glab-tui job 12345        # Check job status
./glab-tui logs 12345       # View job logs
./glab-tui logs --follow 12345  # 🔥 Stream logs in real-time
./glab-tui help             # Show help

⌨️ Keyboard Controls

Key	Action
`q` / `Ctrl+C`	Quit
`j/k` or `↓/↑`	Navigate up/down
`Enter`	Drill down (Pipeline → Jobs → Logs)
`Esc`	Go back
`r`	Refresh
`?`	Help

🚀 Installation

NPX (Recommended)

npx glab-tui                # Zero install, just works!

Download Binary

# Linux/macOS
curl -L https://github.com/rkristelijn/glab-tui/releases/latest/download/glab-tui-linux-amd64 -o glab-tui
chmod +x glab-tui

# Or with Go
go install github.com/rkristelijn/glab-tui@latest

🔧 Requirements

GitLab CLI (glab) - Install from cli.gitlab.com
Authentication - Run glab auth login first
Git repository - Run from inside a GitLab project

📊 User Experience

Feature	glab CLI	glab-tui
Visual Overview	❌ Plain text	✅ Color-coded dashboard
Multi-pipeline View	❌ One at a time	✅ All at once
Navigation	❌ Type commands	✅ Keyboard shortcuts
Real-time Updates	❌ Manual refresh	✅ Live monitoring

Result: Better workflow + visual experience 🏆

🎨 Interface Preview

┌─ GitLab TUI - my-awesome-project ──────────────────────────────────────┐
│ [P]ipelines [J]obs [L]ogs                                         [?] │
├─────────────────────────────────────────────────────────────────────────┤
│ Pipelines                                               ↻ Auto-refresh │
│ ● #1234567  running   feat/new-feature    (2m ago)  [●●●○○○] 3/6 jobs │
│ ✓ #1234566  success   main                (1h ago)  [●●●●●●] 6/6 jobs │
│ ✗ #1234565  failed    fix/bug-123         (2h ago)  [●●●✗○○] failed   │
├─────────────────────────────────────────────────────────────────────────┤
│ Jobs (Pipeline #1234567)                                               │
│ ✓ build          success   (45s)   Dependencies installed             │
│ ● test           running   (12s)   Running test suite...              │
│ ○ deploy         pending           Waiting for tests                   │
└─────────────────────────────────────────────────────────────────────────┘

💬 What Users Say

"Finally, a GitLab interface that doesn't make me want to cry."
— Frontend Developer

"Much better overview than running glab commands repeatedly."
— DevOps Engineer

"It's like k9s but for GitLab. Love the visual dashboard."
— Platform Engineer

🤝 Contributing

We welcome contributions! Please see our Contributing Guide.

📄 License

MIT License - See LICENSE for details.

🙏 Acknowledgments

Inspired by k9s - The gold standard for Kubernetes TUI
Built with Bubble Tea - Excellent Go TUI framework
Powered by GitLab CLI - Official GitLab command line tool

Transform your GitLab workflow today! 🚀