# pueue

> Command-line task management tool for sequential and parallel execution of long-running shell commands

Stars: 6.4k · Language: Rust · License: Apache-2.0 · Categories: Productivity

- Repository: https://github.com/Nukesor/pueue
- Page: https://www.trmn.sh/tools/pueue

## Install

- Cargo: `cargo install --locked pueue`

## Overview

Pueue is a command-line task management tool that processes queues of shell commands with support for both sequential and parallel execution. It consists of a background daemon (`pueued`) that continuously processes tasks and a client (`pueue`) for queue management. The daemon runs independently of terminal sessions, allowing users to add, monitor, and control tasks from any terminal on the same machine.

The tool supports multiple concurrent task execution with configurable parallelism limits, task dependencies, and scheduling for specific execution times. Users can organize tasks into groups (separate queues), pause and resume individual tasks or entire groups, and send input to running processes. Tasks maintain their original working directories and environment variables, with full shell command support including pipes and redirections.

Pueue provides persistent state management with automatic queue restoration after system crashes and comprehensive logging that survives daemon restarts. Additional features include JSON output for programmatic integration, callback hooks for notifications, and a wait command for synchronizing on task completion. The tool targets individual users managing long-running tasks rather than enterprise-scale job scheduling, with cross-platform support for Linux, macOS, and Windows.

### Installation

```bash
# via Cargo
cargo install --locked pueue
```

![Pueue demo](https://media.trmn.sh/cached/4389ded91639c1f7c8b8735502e2c824b0f0a8f1f7a21f1c9247c87c49944881.gif)

## Alternatives

- [ncspot](https://www.trmn.sh/tools/ncspot.md): Cross-platform ncurses Spotify client written in Rust on librespot, with Vim keybindings and an IPC socket for remote control. Requires Spotify Premium. (Rust, 6.8k stars)
- [Himalaya](https://www.trmn.sh/tools/himalaya.md): Rust CLI for managing email across IMAP, SMTP, JMAP, Gmail, Microsoft Graph and Maildir backends, with multi-account TOML config and JSON output. (Rust, 7.6k stars)
- [presenterm](https://www.trmn.sh/tools/presenterm.md): Terminal slideshow tool that runs markdown files as presentations, with images, themes, code highlighting and execution, and PDF/HTML export. (Rust, 8.9k stars)
- [Numbat](https://www.trmn.sh/tools/numbat.md): Statically typed scientific calculator language with physical dimensions as types and first-class units, with an interactive REPL and unit conversion via ->. (Rust, 2.8k stars)
- [termusic](https://www.trmn.sh/tools/termusic.md): Terminal music and podcast player in Rust with a server/TUI split, rusty, MPV and GStreamer backends, tag editor, and YouTube downloads via yt-dlp. (Rust, 2.2k stars)

---

Canonical: https://www.trmn.sh/tools/pueue