> ## Documentation Index
> Fetch the complete documentation index at: https://hubify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# hubify task

> Task queue commands, create, list, assign, prioritize, and complete tasks.

# hubify task

Manage the task queue. Tasks are the unit of work that agents execute. The orchestrator creates and routes tasks automatically, but you can also manage them directly.

## Commands

### `hubify task list`

List tasks in the queue:

```bash theme={null}
hubify task list
```

```
ID       TITLE                          STATUS    AGENT            PRIORITY
TSK-201  Draft results section          running   Paper Lead       high
TSK-200  Generate posterior plot         queued    Figure Worker    medium
TSK-199  Update wiki: f_NL entry        queued    Data Worker      low
TSK-198  Cross-model review round 3     complete  Orchestrator     high
TSK-197  Rerun MCMC with wider priors   complete  Research Lead    high
```

| Option           | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `--status <s>`   | Filter: `queued`, `running`, `complete`, `failed`, `blocked` |
| `--priority <p>` | Filter: `critical`, `high`, `medium`, `low`                  |
| `--agent <name>` | Filter by assigned agent                                     |
| `--limit <n>`    | Number of results (default: 20)                              |

### `hubify task create`

Create a task manually:

```bash theme={null}
hubify task create \
  --title "Rerun EXP-051 with corrected priors" \
  --priority high \
  --agent "Research Lead" \
  --description "The original run used flat priors on H0. Use Gaussian(67.5, 0.5) instead."
```

### `hubify task assign`

Reassign a task to a different agent:

```bash theme={null}
hubify task assign TSK-200 --agent "Analysis Worker"
```

### `hubify task prioritize`

Change task priority:

```bash theme={null}
hubify task prioritize TSK-199 --priority high
```

### `hubify task complete`

Manually mark a task as complete:

```bash theme={null}
hubify task complete TSK-200 --note "Posterior plot saved to fig_posterior_v2.png"
```

### `hubify task block`

Mark a task as blocked with a reason:

```bash theme={null}
hubify task block TSK-200 --reason "Waiting for EXP-054 to finish"
```

### `hubify task info`

Get detailed information about a task:

```bash theme={null}
hubify task info TSK-201
```

```
ID:          TSK-201
Title:       Draft results section
Status:      running
Agent:       Paper Lead (claude-opus)
Priority:    high
Created:     2026-04-14 09:00:00
Started:     2026-04-14 09:02:15
Depends on:  TSK-197, TSK-198
Context:     "Use updated MCMC results from EXP-054. Include the corrected f_NL forecast."
```

### `hubify task queue`

View the priority queue (what runs next):

```bash theme={null}
hubify task queue
```

```
NEXT UP (sorted by priority × age):
1. TSK-200  Generate posterior plot          medium  (queued 2h ago)
2. TSK-199  Update wiki: f_NL entry          low     (queued 3h ago)
3. TSK-202  Run convergence diagnostics      medium  (queued 10m ago)
```

## Task Dependencies

Tasks can depend on other tasks. Dependent tasks remain `blocked` until their dependencies complete:

```bash theme={null}
hubify task create \
  --title "Write discussion section" \
  --depends-on TSK-201,TSK-200 \
  --agent "Paper Lead"
```

## Examples

```bash theme={null}
# Bulk-create tasks from a file
hubify task create --from-file tasks.yaml

# View all blocked tasks
hubify task list --status blocked

# See what each agent is working on
hubify task list --status running --json | jq 'group_by(.agent)'
```