archibate/dotfiles-opencode / skills/pueue
pueue
UnverifiedThis skill should be used before running non-interactive long-running tasks, computation intensive tasks, background tasks, or needs guidance on the pueue CLI tool usage. TRIGGER when user says "use pueue", "run in background", "queue this task", or when about to run any long-running (>2 min) task.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.5 KB |
| references/pueue.md | markdown | 3.9 KB |
| scripts/run_in_pueue.shexecutable | script | 1.2 KB |
SKILL.md
View on GitHub---
name: pueue
description: This skill should be used before running non-interactive long-running tasks, computation intensive tasks, background tasks, or needs guidance on the pueue CLI tool usage. TRIGGER when user says "use pueue", "run in background", "queue this task", or when about to run any long-running (>2 min) task.
---
# Pueue - Background Task Manager
## When to Use
- Non-interactive long-running tasks expected to run for >2 minutes
- Computation intensive tasks with parallel job scheduling (prevent resource exhaustion)
- Tasks that should continue even if you disconnect
## When NOT to Use
- Short tasks (<2 minutes): run directly
- Interactive commands: use `tmux` instead for TUI access
## Workflow
### Option 1: Add and Follow (Recommended)
Start task and follow its output (blocks until complete):
```bash
# Add task and get its ID
pueue add 'PYTHONUNBUFFERED=1 uv run python -u train.py'
# Follow task output (blocks until complete)
pueue follow <task_id>
```
### Option 2: Add and Check Later
Start task without blocking, check status later:
```bash
# Add task
pueue add 'PYTHONUNBUFFERED=1 uv run python -u train.py'
# Later, check status
pueue status
# View output when done
pueue log <task_id>
```
### Option 3: Using the Helper Script
```bash
scripts/run_in_pueue.sh 'PYTHONUNBUFFERED=1 uv run python -u train.py'
```
This script:
- Auto-starts daemon if needed
- Creates a project-specific group
- Adds the task and follows output
## Conversation Example
User:
Start training in the background.
Assistant:
```bash
pueue add 'PYTHONUNBUFFERED=1 uv run python -u train.py'
```
Then I'll follow the output:
```bash
pueue follow <task_id>
```
Training started. I'll monitor progress and report when complete.
## Quick Reference
| Command | Description |
|---------|-------------|
| `pueue status` | List all tasks |
| `pueue add 'cmd'` | Queue a task |
| `pueue follow <id>` | Follow task output (blocks) |
| `pueue log <id>` | View completed task output |
| `pueue kill <id>` | Kill a running task |
| `pueue clean` | Remove finished tasks |
## Key Pitfalls
- **Always quote the command**: `pueue add 'cmd --flag'` not `pueue add -- cmd --flag`
- **Python needs unbuffered output**: Use `PYTHONUNBUFFERED=1` or `python -u`
- **Use project groups**: `pueue add -g myproject 'cmd'` to avoid mixing tasks
## Skill Files
- `scripts/run_in_pueue.sh` — wraps pueue add with auto daemon start, per-project grouping, and follow
- `references/pueue.md` — comprehensive pueue CLI usage documentation
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |