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:

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:

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:

hubify task assign TSK-200 --agent "Analysis Worker"

hubify task prioritize

Change task priority:

hubify task prioritize TSK-199 --priority high

hubify task complete

Manually mark a task as complete:

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:

hubify task block TSK-200 --reason "Waiting for EXP-054 to finish"

hubify task info

Get detailed information about a task:

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):

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:

hubify task create \
  --title "Write discussion section" \
  --depends-on TSK-201,TSK-200 \
  --agent "Paper Lead"

Examples

# 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)'