Work in the Task Workspace
Opening a task from anywhere lands you in the Task Workspace: one page that holds the spec, the work, the breakdown, and the conversation. This tour uses SUM-14, the offline maps task Rhea is working on.
You can reach it by short key. /app/tasks/SUM-14 resolves the same as the full identifier, which is why the docs quote keys.
The header
Section titled “The header”
The header carries the title, the short-key badge, and two badges you can edit in place:
- Status. Select it to pick another status. The workspace saves as soon as you choose, and a move the lifecycle does not allow comes back as an error rather than a silent no-op. See task lifecycle.
- Priority. Low, normal, high, or urgent.
Under them, the origin badge says where the task came from (typed in by hand, merged from a meeting, or spawned by another task) and links back to it. Milestones at the right opens the execution timeline.
The status banner
Section titled “The status banner”Below the header sits one banner with the single next action, chosen from the task’s actual state:
| When | The banner says | The action |
|---|---|---|
| An agent is running | Agent running, with the current step and budget | Open execution |
| The agent paused for you | Agent paused, needs you | Approve or Reject |
| A run is under way | Run in progress, with the attempt count | View run |
| The task is blocked | What it is waiting on | Diagnose |
| Nobody is on it | No one is working on this yet | Assign |
| It is open or in progress, with nothing running | Whether the last run finished, or that it has not run yet | Review run, or Open execution |
| It finished | Whether the last run was accepted or rejected | Review run |
The only task without a banner is one parked in the backlog, which is the one state with nothing to do next.
The workspace opens on Execution when a run is live or the task is blocked, and on Overview otherwise, so the tab you land on is the one with the answer.
Overview
Section titled “Overview”The spec and its metadata.
- Summary is the task description, rendered from Markdown.
- A typed panel appears above it for specialized types: a content task’s active child, a verification’s rubric, an approval’s proposed action.
- The Details sidebar holds owner, assignee, created, updated, due, created by, project, meeting, and parent task. Assignee and due date are editable in place, the same way status is.
- Advanced fields at the bottom is collapsed by default and holds the identifiers you need only when quoting the task to support.
Execution
Section titled “Execution”Everything that has actually run.
- Runs, newest first, each with its status, its outcome once it has one, and its attempt count against the cap. Select one to open the run.
- Agent run, when the task carries a step-by-step plan: the plan, its timeline, the budget spent against its cap, and any artifacts produced. A paused step gets Approve step and Reject step here.
A task nothing has executed says so rather than showing an error.
Subtasks
Section titled “Subtasks”The child tasks of this one, with each child’s status, assignee, and due date. See subtasks and milestones.
Activity
Section titled “Activity”The task’s conversation and history: comments from you, notes from agents, and the events that moved it. Use it to leave a correction an agent should read before its next attempt.
Next steps
Section titled “Next steps”- Move a task through its statuses: the legal transitions and how to unblock.
- Assign a task: who does the work, and what assignment starts.
- Runs and attempts: what the Execution tab is showing you.