# Yao Job

Background job management, start, monitor, wait, stop long-running commands.

- Repository: https://github.com/YaoApp/yao (8244 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add YaoApp/yao --skill yao-job -g -a claude-code -y`
Codex: `npx skills add YaoApp/yao --skill yao-job -g -a codex -y`
Cursor: `npx skills add YaoApp/yao --skill yao-job -g -a cursor -y`
Gemini CLI: `npx skills add YaoApp/yao --skill yao-job -g -a gemini-cli -y`

## Description

Background job management, start, monitor, wait, stop long-running commands. ALWAYS invoke this skill when the user asks to run background tasks, check job status, read job output, or manage long-running commands.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Background Jobs

## Tools

- `yao_job_start`, Start a command. `background false` (default) blocks until done and returns `output_tail`; `background true` returns `job_id` immediately.
- `yao_job_list`, List jobs. Supports `--status` filter and `--limit`/`--offset` pagination.
- `yao_job_get`, Get full details for a job (or daemon by ID).
- `yao_job_output`, Read process output (works for both job and daemon IDs).
- `yao_job_wait`, Block until a background job finishes or timeout expires. Jobs only, not daemons.
- `yao_job_stop`, Kill a running job.

## Parameters

### yao_job_start

| Param | Required | Default | Description |
|-------|----------|---------|-------------|
| `command` | yes |, | Shell command to execute |
| `description` | yes |, | Concise 5, 10 word summary |
| `background` | no | `false` | `true` returns immediately; `false` blocks until done |
| `args` | no |, | Additional arguments (rarely needed; prefer inline in `command`) |
| `working_dir` | no | workspace | Working directory |
| `max_duration_ms` | no |, | Kill the job after this many milliseconds |

### yao_job_list

| Param | Default | Description |
|-------|---------|-------------|
| `status` | all | Filter: `running`, `stopping`, `completed`, `failed`, `cancelled`, `all` |
| `limit` | 20 | Max items per page |
| `offset` | 0 | Skip first N items |

### yao_job_output

| Param | Required | Description |
|-------|----------|-------------|
| `job_id` | yes | Job or daemon ID |
| `offset` | no | Byte offset to read from (0 = beginning) |

The rest: https://github.com/YaoApp/yao/blob/HEAD/tools/skills/yao-job/SKILL.md