pueue

pueue command [options]

pueue is a command-line task queue manager that schedules and runs shell commands sequentially or in parallel in the background. Tasks are added to a queue and executed by the pueued daemon, which persists across terminal sessions and system reboots.The tool provides task lifecycle management including pausing, resuming, killing, and restarting tasks. Task output is captured and can be followed in real time with follow or reviewed later with log. Groups allow organizing tasks into separate queues with independent parallelism settings.

add [options] -- CMD

Add a task to the queue. Use -g group to assign to a group, -d to start in paused state, -a ID to add a dependency on another task, -l label to assign a label.

Show queue status. Use -j for JSON output.

Resume a specific paused task, or start the entire default group if no ID given.

Pause a specific task, or the entire default group if no ID given.

Remove a task from the list (only finished or queued tasks).

Stream task output in real time.

Show captured output of finished tasks.

Kill a running task or all tasks in a group.

Restart a finished or failed task.

Remove all finished tasks from the list.

Kill all tasks and remove everything.

Manage task groups. Groups allow independent parallel queues.

Set the number of tasks that run in parallel (default: 1).

~/.config/pueue/pueue.yml

Client and daemon configuration file defining default parallelism, callback commands, and daemon socket path.

Requires the pueued daemon to be running. Start it with pueued -d (daemonized). Task state persists across terminal sessions and daemon restarts.

Pueue (German for "queue") was created by Arne Beer for managing long-running shell commands in the background. Written in Rust.

nohup(1), screen(1), tmux(1), at(1), batch(1), task(1)