pueue-reset

Kill all tasks and remove everything (logs, status, groups, task IDs)

$ pueue reset

$ pueue reset --children

$ pueue reset [[-f|--force]]

pueue reset [GLOBAL OPTIONS]

--config <FILE>
    Specifies an alternative path to a Pueue configuration file. By default, Pueue looks for its configuration in standard locations like ~/.config/pueue/pueue.yml.

--color <WHEN>
    Controls when to use colored output. Possible values are always, auto (default), and never. auto detects if the output is a TTY.

--debug
    Enables verbose debug logging for the command's execution, which can be helpful for troubleshooting.

--json
    Outputs the command's result in JSON format, useful for scripting and programmatic integration.

--profile <NAME>
    Selects a specific configuration profile defined within the Pueue configuration file. This allows managing multiple independent Pueue instances or configurations.

pueue-reset is a subcommand of the Pueue task queue manager. It is used to completely reset the daemon's state, effectively clearing all managed tasks and groups. When executed, pueue-reset stops the currently running Pueue daemon, removes all task data, logs, and group definitions from the daemon's storage location, and then restarts the daemon. This command is useful when you want to start fresh with Pueue, discarding all previous tasks, their outputs, and the current queue's state. It provides a clean slate, making it an essential tool for development, testing, or when an accumulated history of tasks is no longer desired.

It's important to understand that this operation is destructive and irreversible for the data stored by Pueue.

Data Loss: The pueue reset command is destructive. It permanently deletes all queued, running, finished, and failed tasks, along with their associated logs and output, and all defined groups. This action cannot be undone.

Daemon Restart: The command stops the Pueue daemon and then restarts it. This will briefly interrupt any ongoing Pueue operations or client connections. Ensure no critical tasks are actively relying on the daemon during the reset.

Permissions: You need appropriate file system permissions to delete the Pueue daemon's data directory and logs, typically located in ~/.local/share/pueue or similar user-specific paths.

Executing pueue reset essentially brings the Pueue daemon back to its initial, uninitialized state. All previous task IDs are discarded, and new tasks will start from ID 0. This is different from pueue clean, which only removes finished tasks but preserves the current task IDs and the state of active tasks.

Pueue (pronounced "queue") is a relatively modern task queue manager written in Rust. It was created to provide a simple, robust, and user-friendly way to manage and execute shell commands asynchronously in the background. The pueue reset command has been a fundamental part of Pueue's functionality since early versions, providing a straightforward mechanism for users to clear their task history and restart the queue from a clean state. Its design emphasizes ease of use and minimal configuration.

pueue(1), pueue start(1), pueue stop(1), pueue status(1), pueue clean(1), pueue add(1)