pueue-group
Manage groups of enqueued tasks
TLDR
Show all groups with their statuses and number of parallel jobs
Add a custom group
Remove a group and move its tasks to the default group
SYNOPSIS
pueue group <command> [options] [arguments]
PARAMETERS
add <group name>
Adds a new group with the given name.
remove <group name>
Removes a group with the given name.
rename <group name> <new group name>
Renames a group from <group name> to <new group name>.
default
Sets the default group for new tasks. Any tasks added without specifying a group will be added to the default group.
default <group name>
Sets <group name> as the new default group.
list
Lists all existing groups.
DESCRIPTION
pueue-group allows users to manage tasks within specific, named groups. This is an extension of the pueue task manager, providing finer-grained control over job execution beyond the standard queue structure.
Groups offer a logical separation of tasks, enabling you to start, stop, pause, and display jobs belonging to a particular category. This is useful for prioritizing different projects, dedicating resources to specific types of workloads, or simply improving the organization of a large number of queued tasks.
By creating groups with descriptive names, users gain a clear overview of active and pending tasks. This makes managing complex workflows simpler and more intuitive than dealing with a flat queue.
WORKFLOW EXAMPLES
1. Create groups for different projects: pueue group add project_a, pueue group add project_b
2. Add tasks to specific groups: pueue add --group project_a 'long_running_task_1', pueue add --group project_b 'build_project_b'
3. Start all tasks in a group: pueue start --group project_a
4. List all groups: pueue group list
SEE ALSO
pueue(1), pueue-add(1), pueue-start(1), pueue-pause(1)