pueue-reset
Clear all tasks from the Pueue queue
TLDR
Kill all tasks and remove everything (logs, status, groups, task IDs)
Kill all tasks, terminate their children, and reset everything
Reset without asking for confirmation
SYNOPSIS
pueue reset [--force]
PARAMETERS
--force
Bypass the confirmation prompt, executing the reset immediately.
DESCRIPTION
The pueue reset command is a powerful tool to completely clean the state of the pueue daemon. It removes all pending, running, and finished tasks. This includes the task history and any temporary files associated with the tasks. Be extremely cautious when using this command, as it results in permanent data loss of your pueue task information.
It essentially wipes the slate clean, allowing you to start with a fresh pueue instance, free of any previous job information. Use this when encountering severe issues with the pueue daemon or when a clean start is desired. If pueue daemon is running, command will stop it before process the reset operation.
It's generally used in development or debugging to handle unexpected server states.
CAVEATS
Using pueue reset is a destructive operation. All task data, including logs and any results produced by the tasks, will be irrevocably lost. Ensure this is the desired outcome before running the command.
CONFIRMATION
Without the --force flag, pueue reset will prompt for confirmation before executing. This helps prevent accidental data loss. Always consider the ramifications before confirming.
USE CASES
Common scenarios for using pueue reset include:
- Recovering from corrupted pueue database files.
- Starting a new project with a fresh queue.
- Completely removing all task data for privacy or security reasons.
- Resetting after debugging to ensure a clean slate before deployment.