Tasks

Tasks are jobs the agent can run — either on demand or on a schedule. Use them for anything you want the agent to do repeatedly, or anything you want to launch and come back to later.

Creating a task

From a project's Tasks tab, click New task and give it a name. Open the task to configure:

  • Prompt — what you want the agent to do on each run. This is the instruction the agent sees when the task fires.
  • Notes — persistent context about the task (e.g. "email me at austen@…", "use the prod GCP project"). Survives across runs.
  • Schedule — how often the task should run (see below).

One-off vs recurring

  • One-off — set a specific future date and time. The task runs once, then unschedules itself.
  • Recurring — set an interval (e.g. every hour, every day at 9am). The task runs on that schedule indefinitely until you stop it or mark it complete.
  • No schedule — leave scheduling off and run it manually whenever you want.

Running manually

Open a task and hit Start. The agent executes the task's prompt using everything configured on the project (tools, modules, instructions). You can watch it work in the task's chat, and chat with it there if you want to intervene or ask questions during the run.

If a run is already in progress, Start is replaced by Stop — click it to abort the current run.

Only one run per task can be active at a time. If you click Start while the task is already running (or a scheduled run just fired), you'll be told it's already running instead of queueing another one up.

Subtasks

A task can have subtasks — useful for breaking a larger piece of work into steps or for letting the agent itself create a list of to-dos beneath a parent task.

Status

  • Incomplete — active, can run manually or on its schedule.
  • Recurring — active with a recurring schedule set.
  • Complete — done. No further scheduled runs.
  • Cancelled — stopped. No further scheduled runs.

Task chat

Every task has its own chat, separate from the project's main chat. You can:

  • Type in it like a regular chat — useful for iterating on what the task should do.
  • Watch scheduled runs execute live, with every tool call and message visible.
  • Click Start from the chat to trigger the task immediately.

Good uses for tasks

  • Daily briefings ("every morning at 7am, email me a summary of new GitHub issues").
  • Monitoring ("every 15 minutes, check if our homepage is up; page me if not").
  • Weekly reports.
  • Ad-hoc "run this for me and come back with results" jobs.
  • Multi-step workflows you'd otherwise do manually.