pueue-clean
Remove finished or failed pueue tasks
TLDR
Remove finished tasks and clear logs
Only clean commands that finished successfully
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
pueue-start(1), pueue-status(1), pueue-log(1)