LinuxCommandLibrary

pueue-clean

Remove finished or failed pueue tasks

TLDR

Remove finished tasks and clear logs

$ pueue clean
copy

Only clean commands that finished successfully
$ pueue clean [[-s|--successful-only]]
copy

SYNOPSIS

pueue clean [OPTIONS]

PARAMETERS

--help
    Show help message and exit

-f, --force
    Force the removal of tasks without prompting for confirmation.

-s, --successful
    Only remove tasks that finished successfully.

-e, --errored
    Only remove tasks that resulted in an error.

-r, --remove-all
    Removes all tasks. Use with caution.

DESCRIPTION

The `pueue-clean` command removes finished or failed tasks from Pueue's task list and the daemon's log files. This helps to keep the list of tasks manageable and prevents the logs from growing too large.

By default, `pueue-clean` will remove all tasks that have either finished successfully or failed. Options are available to filter what kind of tasks are going to be removed. This provides flexibility in managing the task history and freeing up resources. Running `pueue-clean` without options will remove all finished and failed tasks. You must have the Pueue daemon running for the clean command to work.

EXIT CODES

0: Successful execution.
1: An error occurred, such as the Pueue daemon not running.

EXAMPLES

pueue clean: Removes all finished and failed tasks.
pueue clean --successful: Removes only successfully finished tasks.
pueue clean --errored: Removes only tasks that resulted in an error.
pueue clean --force: Force removal of tasks without confirmation.
pueue clean --remove-all: Removes all tasks.

SEE ALSO

Copied to clipboard