Skip to main content
When you’re working on complex research with multiple steps and dependencies, Qualia’s task system helps you organize the work. Tasks can depend on earlier steps and be assigned to different agents.

Understanding tasks

A task represents a unit of work:
  • Title: What needs to be done
  • Objective: Detailed description of the goal
  • Status: Where the task is in its lifecycle
  • Dependencies: Other tasks that must complete first
  • Assignment: Which agent is working on it

Task statuses

Tasks move through a defined lifecycle:

Blocking

Tasks can be blocked when they depend on upstream tasks that haven’t completed yet. Blocking is tracked separately from status — a planned task may be blocked or unblocked depending on whether its dependencies are satisfied. When upstream tasks complete, blocked tasks automatically become unblocked and available to start.

Open Project view

Click Project in the top right to see your workspace tasks and knowledge. Hover over the button for a preview. A spinner indicates running work; a blue dot indicates new knowledge.

Tasks and Knowledge side by side

Project view shows the task dependency map beside the full Knowledge list, with search, filters, review actions, and source navigation. Narrow panes stack Knowledge under the map so both remain accessible. Drag the divider to resize the panels. Click a task to see its objective and assigned agent, or a claim to inspect its sources.

Task cards

Cards show task names, status, and results as you zoom in. Running tasks show the agent’s progress. Select a card for full details.

Creating tasks

Ask an agent in chat to plan the work, or drag from a task’s connection handle to add a dependent task. Describe the work in natural language:
“Analyze this dataset: clean the data, run three different models, compare their performance, and summarize the best approach.”
The request is handed to the agent you picked, which plans the work into linked tasks with appropriate dependencies and assigns each one to an executor.

Task groups

Agents can gather related tasks, such as the runs of a sweep, into a named task group. A group is only a visual folder: it never changes dependencies or when a task runs, and agents can move tasks in or out of it at any time. Agents can choose a group icon from a fixed set; existing groups use a folder until changed.
  • Collapsed groups show a compact folder icon, title, and task count, with a soft color shared by the expanded frame. Click a card or focus it and press Enter or Space to expand it; use the chevron in the frame’s header to collapse it again. Drag a frame by its header to move the whole group. The fold button in the map controls expands or collapses every group at once.
  • Groups expand and collapse with a short transition; reduced-motion preferences make the change immediate. Each group’s expanded state is remembered on your device, independently of other groups.
  • Consolidate group inputs/outputs (the merge icon in the map controls) draws every dependency that crosses a group’s edge to or from the group itself instead of the individual task inside it. Turn it off to see each task’s own connections.

Modifying and deleting tasks

You can edit or remove planned tasks before they start:
  • Edit: Click a planned task to modify its title, objective, or dependencies
  • Delete: Remove tasks that are no longer needed
Once a task starts, use Cancel task in its detail menu to stop that work. Editing and deletion are available only while a task is planned.

Tasks and agents

Tasks and agents work together:
  • Agents can have multiple tasks assigned to them
  • An agent works through its tasks, respecting dependencies
  • When you create parallel agents, each can take on different tasks
The agent confirmation setting in Settings > Agents controls whether new agent creation requires your approval.

Tasks and knowledge

When an agent completes a task, it typically produces claims in the Knowledge System. This claim captures what the agent learned or concluded, with links back to the evidence (code cells, files, other claims). Tasks can capture values and figures from notebooks and scripts. See Task variables for sharing results between steps.

Task activity in chat

Chat activity shows when agents create, update, or reassign tasks. Click a task title to open it in Project. Expand a grouped row to see each task.

Viewing task progress

Inline summary

Assigned tasks appear beneath each agent in the Agents sidebar. Hover over a task summary to see additional tasks, or open Project for the full map.