Skip to main content

​
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
OptionDescription
--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)'