Linux command
pueue 命令
安全
权限或系统影响较大，执行前请核对目标。
常用示例
Add a command to the queue
pueue add -- [command]
Add a task to a specific group
pueue add -g [group_name] -- [command]
List all tasks and their status
pueue status
Start processing the queue
pueue start [task_id]
Pause the queue
pueue pause [task_id]
Follow task output
pueue follow [task_id]
Show the output log
pueue log [task_id]
Remove a finished task
pueue remove [task_id]
Kill a running task
pueue kill [task_id]
Restart a failed or finished task
pueue restart [task_id]
说明
pueue is a command-line task queue manager that schedules and runs shell commands sequentially or in parallel in the background. Tasks are added to a queue and executed by the pueued daemon, which persists across terminal sessions and system reboots. The tool provides task lifecycle management including pausing, resuming, killing, and restarting tasks. Task output is captured and can be followed in real time with follow or reviewed later with log. Groups allow organizing tasks into separate queues with independent parallelism settings.
参数
- add _options_ -- _CMD_
- Add a task to the queue. Use -g _group_ to assign to a group, -d to start in paused state, -a _ID_ to add a dependency on another task, -l _label_ to assign a label.
- status _-j_
- Show queue status. Use -j for JSON output.
- start _ID_
- Resume a specific paused task, or start the entire default group if no ID given.
- pause _ID_
- Pause a specific task, or the entire default group if no ID given.
- remove _ID_
- Remove a task from the list (only finished or queued tasks).
- follow _ID_
- Stream task output in real time.
- log _ID_
- Show captured output of finished tasks.
- kill _ID_
- Kill a running task or all tasks in a group.
- restart _ID_
- Restart a finished or failed task.
- clean
- Remove all finished tasks from the list.
- reset
- Kill all tasks and remove everything.
- group _add_|_remove_ _name_
- Manage task groups. Groups allow independent parallel queues.
- parallel _N_ _-g group_
- Set the number of tasks that run in parallel (default: 1).
FAQ
What is the pueue command used for?
pueue is a command-line task queue manager that schedules and runs shell commands sequentially or in parallel in the background. Tasks are added to a queue and executed by the pueued daemon, which persists across terminal sessions and system reboots. The tool provides task lifecycle management including pausing, resuming, killing, and restarting tasks. Task output is captured and can be followed in real time with follow or reviewed later with log. Groups allow organizing tasks into separate queues with independent parallelism settings.
How do I run a basic pueue example?
Run `pueue add -- [command]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does add _options_ -- _CMD_ do in pueue?
Add a task to the queue. Use -g _group_ to assign to a group, -d to start in paused state, -a _ID_ to add a dependency on another task, -l _label_ to assign a label.