LinuxCommandLibrary

pueue-group

Manage groups of enqueued tasks

TLDR

Show all groups with their statuses and number of parallel jobs

$ pueue group
copy

Add a custom group
$ pueue group add "[group_name]"
copy

Remove a group and move its tasks to the default group
$ pueue group remove "[group_name]"
copy

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

Copied to clipboard