Work With Tasks

Tasks are small units of work with status, owner, priority, schedule, and history.

List

List tasks

todos list

Add task

todos add "Fix production health check"

Scheduled task

platform-todos tasks add "Refresh release notes" --due 2026-05-22T09:00:00Z --start-after 2026-05-21T09:00:00Z --recurrence weekly --sla-minutes 120

Show details

todos show <task-id>

Start work

todos start <task-id>

Claim next ready task

platform-todos tasks claim --worker codex

Mark done

todos done <task-id>

Field	Use
Title	The outcome.
Description	The context.
Priority	What should happen first.
Status	Pending, in progress, blocked, or done.
Schedule	Due date, delayed start, recurrence, and SLA window.
Comments	Decisions and verification notes.