pueue-tui 0.1.0

A beautiful terminal UI for monitoring pueue tasks

🖥️ pueue-tui

A terminal UI for monitoring pueue tasks.

Features • Installation • Usage • Keybindings • Compatibility

---

Tired of running pueue status over and over? pueue-tui gives you a live-updating dashboard for your running, queued, and completed tasks.

Features

• 📊 Live dashboard — auto-refreshing view of all tasks
• ⏱️ Timing info — start time, end time, and duration at a glance
• 🔍 Command preview — select a row to see the full command
• ⌨️ Keyboard shortcuts — quick actions without leaving the terminal

Installation

# Recommended
pipx install pueue-tui

# Or with pip
pip install pueue-tui

Usage

# Start with default 2-second refresh
pueue-tui

# Custom refresh interval  
pueue-tui -r 1    # 1 second
pueue-tui -r 5    # 5 seconds

# Show more completed tasks
pueue-tui --completed 20

Keybindings

Key	Action
q	Quit
r	Refresh now
c	Clean finished tasks

Compatibility

Tested with pueue v4.x

pueue-tui parses the JSON output from pueue status --json. The JSON structure may differ between major pueue versions. If you encounter issues with a different version, please open an issue.

Requirements

• Python 3.10+
• pueue daemon running

Contributing

Contributions welcome! Feel free to open issues or submit PRs.

License

MIT