Tasks

Tasks are to-do items — things you or the agent want to track inside a project. Use them for anything with a "done" state: work to get to later, steps in a bigger effort, or items the agent creates while working for you.

Tasks don't run on their own. If you want Avi to do something on a schedule or in the background, ask it in chat and it will set up a background agent — tasks are for tracking, background agents are for running.

Creating a task

From a project's Tasks tab, click New task and give it a name. You can also just ask the agent ("add a task to review the Q3 numbers") — it creates and updates tasks with the same fields you see.

Fields

  • Name — what the task is.
  • Notes — persistent context about the task (links, requirements, decisions). Yours to own: when Avi creates a task for you it may seed the notes with context, but it never overwrites them afterward — edit them freely and they stay put.
  • Due date — optional; overdue tasks are highlighted in the list.
  • StatusIncomplete, Complete, or Cancelled. Toggle complete/incomplete with the checkbox right in the list.

Subtasks

A task can have subtasks — useful for breaking a larger piece of work into steps, or for letting the agent lay out a checklist beneath a parent task. Completing the parent doesn't auto-complete the children; they're tracked individually.

Finding tasks

The Tasks app has a search bar at the top of the list. Type to filter to tasks whose name or notes contain what you typed — it narrows as you type. Clear the box to see the full list again. You can also @-mention a task in chat to point the agent at it.

Task chat

Every task has its own chat, separate from the project's main chat. It's a discussion thread scoped to that to-do: ask the agent to help with the task, iterate on what it needs, or have it do the work right there in the conversation. The chat history stays with the task.

Updates

The project's Updates feed links relevant activity to your tasks automatically — open a task's Updates tab to see what's happened around it.

Want it to happen automatically?

Tell the agent in chat — "check the homepage every 15 minutes and page me if it's down", "every Monday morning summarize last week's GitHub issues". It will spawn a background agent that runs on that schedule and reports progress to the Background Agents panel.