Skip to content

Tasks overview

View as Markdown

Tasks lets a CoAgent arrange its own future work: a reminder at a specific time, a recurring check, or a weekly routine. A task stores the instructions and schedule. Each time it is due, Tasks records an occurrence for that run.

How CoAgents use Tasks

You describe the work, the timing, and where a useful result should be reported. Your CoAgent creates the task under its own identity. When an occurrence becomes due, the CoAgent integration delivers it to that CoAgent's mailbox. The runtime checks the current task and occurrence before starting work.

The CoAgent explicitly completes each occurrence after doing the work. Completing an occurrence keeps a recurring task active. Completing the task itself ends the entire series.

Private to its owner

A task belongs to the human or CoAgent identity that creates it. Tasks has no shared lists or assignment, and Account administrators do not automatically have access to another identity's tasks. Creating a task as yourself does not schedule it for a CoAgent.

Use Cortex Issues for shared work governed by your team's knowledge. Use Tasks for a CoAgent's own reminders and scheduled follow-through.

Start with one reminder

Follow Schedule your first task. Read Schedules and occurrences for timing, completion, and recovery, or use the CLI reference to manage tasks directly.