pgqueue-dash

pgqueue-dash 🐘

A high performance Terminal User Interface (TUI) app for monitoring the pgqueue task queue. Its been built with Golang, Bubble Tea, Bubbles, and Lip Gloss to be a fast, memory efficient and lightweight dashboard.

Features

• Live Metrics

  • Real-time task state distribution (pending, processing, failed, retrying, completed)

• Powerful Search

  • PostgreSQL full-text search over task type and error messages
  • Instant filtering without leaving the TUI

• Task & Cron Inspection

  • Scrollable detail modals
  • Pretty-printed, syntax-highlighted JSON payloads

• Pagination at Scale

  • Efficient browsing of millions of rows using LIMIT / OFFSET

• Actionable Operations

  • Retry failed tasks with confirmation

• Keyboard-First UX

  • Vim-style navigation (h, j, k, l)

Installation

go install github.com/i-christian/pgqueue/cmd/pgqueue-dash@latest

Keyboard Shortcuts

Global

Navigation (Vim-compatible)

Tasks Tab

Cron Jobs Tab

Screenshots 📸

Overview

Tasks View

Task Detail (JSON Payload)

Configuration

Configuration can be provided via environment variables or CLI flags. CLI flags always take precedence.

Environment Variables

export PG_CONN_STRING="postgres://user:pass@localhost:5432/dbname"
pgqueue-dash

CLI Flags (recommended)

pgqueue-dash \
  --dsn="postgres://user:pass@localhost:5432/task_queue?sslmode=disable" \
  --poll=2s

CLI Arguments