Tasks

Task commands cover the day-to-day work in Plot. Use them to inspect what needs doing, create new work, update status, manage dependencies, and keep subtasks organized.

plot task me

Use plot task me to list tasks assigned to the current user. This is the fastest way to check what is on your plate.

plot task me

Include completed or inactive work when you need a broader view.

plot task me --show-completed
plot task me --show-inactive

plot task list

Use plot task list to list tasks with filters for team, project, assignee, status, labels, priority, and parent task.

plot task list --team ENG --status "In Progress"

List subtasks by passing a parent task ID.

plot task list --parent ENG-042

plot task get

Use plot task get to read full task details. The response includes related context such as project, team, dependencies, subtasks, and other hydrated relations.

plot task get ENG-042

For agents or scripts:

plot task get ENG-042 --format json

plot task create

Use plot task create to create a single task. At minimum, pass a name and team. You can also set project, assignee, status, dates, labels, parent task, and dependencies in the same command.

plot task create --name "Write launch notes" --team MKT --assignee @me

Use @me to assign the task to the authenticated user.

plot task create --name "Follow up with design" --team DES --assignee @me

plot task create-tree

Use plot task create-tree to create a parent task with one level of subtasks from JSON. This is useful for planning a small work tree in one operation.

cat <<'JSON' | plot task create-tree --format json
{
  "name": "Ship checkout polish",
  "team": "ENG",
  "project": "checkout-redesign-a1b2c3d4e5f6",
  "subtasks": [
    { "name": "Fix empty state", "ref": "empty-state" },
    { "name": "Add regression coverage", "blockedBy": ["@empty-state"] }
  ]
}
JSON

plot task update

Use plot task update to change mutable task fields such as status, assignee, priority, description, dates, project, team, and labels.

plot task update ENG-042 --status "Done"

Use none to clear a nullable assignee.

plot task update ENG-042 --assignee none

plot task delete

Use plot task delete to soft-delete a task. The task is removed from normal active views without permanently erasing workspace history.

plot task delete ENG-042

plot task add-dependency

Use plot task add-dependency when one task must wait for another task before it can be completed.

plot task add-dependency --task ENG-042 --blocked-by ENG-041

plot task remove-dependency

Use plot task remove-dependency to remove a blocking relationship between two tasks.

plot task remove-dependency --task ENG-042 --blocked-by ENG-041

plot task set-parent

Use plot task set-parent to convert an existing task into a subtask of another task.

plot task set-parent ENG-043 --parent ENG-042

plot task remove-parent

Use plot task remove-parent to promote a subtask back to a top-level task.

plot task remove-parent ENG-043