doto task

Create, view, update, and act on tasks.

Task commands only show tasks you created, tasks assigned to you, and tasks that belong to one of your teams. Updating a task requires you to be the creator or assignee. Deleting a task requires you to be the creator.

---

doto task create

Create a new task.

doto task create --title <title> [options]

Flags

Flag	Required	Description
--title <title>	✅	Task title
--description <desc>		Longer description
--priority <p>		P0–P3 (default: P2)
--team <id>		Associate with a team
--assign <userId>		Assign to a user
--parent <taskId>		Create as a subtask

Examples

# Create a task for yourself
doto task create --title "Write release notes" --priority P1

# Assign to a teammate
doto task create --title "Review PR #42" \
  --priority P1 \
  --team <team-id> \
  --assign <user-id>

# Create a subtask
doto task create --title "Write unit tests" --parent <task-id>

Self-assigned tasks start as ACCEPTED. Tasks assigned to others start as INBOX.

---

doto task list

List tasks visible to your account with optional filters.

doto task list [options]

Flags

Flag	Description
--status <s>	Filter by status
--priority <p>	Filter by priority
--team <id>	Filter by team
--limit <n>	Page size (default: 20)
--cursor <c>	Pagination cursor

doto task list --status IN_PROGRESS
doto task list --priority P0 --json
doto task list --limit 5
# More available. Use --cursor eyJpZCI6Ii4uLiJ9

---

doto task show

Show full details for a task, including its subtasks.

doto task show <id> [--json]

---

doto task update

Update a task's fields. You must be the task creator or assignee.

doto task update <id> [options]

Flag	Description
--title <t>	New title
--description <d>	New description
--priority <p>	New priority

---

doto task delete

Soft-delete a task. You must be the task creator. The task and all its subtasks are hidden but not permanently removed.

doto task delete <id>

Status transitions

doto task accept <id>                        # INBOX → ACCEPTED
doto task start <id>                         # ACCEPTED → IN_PROGRESS
doto task done <id>                          # IN_PROGRESS → DONE
doto task reopen <id>                        # DONE → IN_PROGRESS
doto task reject <id>                        # INBOX → REJECTED
doto task resend <id>                        # REJECTED → INBOX
doto task clarify <id> --message <text>      # INBOX → NEEDS_CLARIFICATION