Understanding the Task View and Statuses
Understanding the Task View and Statuses
The Agent task view is used to get a consolidated look at multiple Agent tasks. Its goal is to let you tell at a glance which tasks are working, which need your input, which have finished, and which have failed.
The design of this task view draws on the customer experience of Claude Code's Agent View: let the user see status first, then open details, reply, approve, or take over only when needed.
What the task view shows
Each task row typically includes:
- Task name.
- Working mode.
- Current status.
- What it's currently doing.
- Last update time.
- The Agent role responsible.
- Whether user input is needed.
- Whether there's a pending approval.
- Whether there are deliverables.
- Whether there's a failure reason.
- Model consumption and budget status.
The working mode affects what you see
Different working modes emphasize different things in the task view.
| Mode | Task view focus | Most common user actions |
|---|---|---|
| Sub mode | Sub-agent status, blockers, explicit handoffs, result aggregation | Stop a sub-agent that's off track, add context, approve high-risk actions |
| Swarm mode | The lead's task decomposition, each worker's claim/execution status, result aggregation | Handle a blocked worker, adjust budget, or take over |
| Waterfall mode (fixed 5-role template) | Current stage, stage output, stage confirmation, release approval | Confirm stage results, roll back to the previous stage, approve release |
| Agile mode (fixed 3-role template) | This round's goal, this round's deliverables, feedback items, suggestions for the next round | Accept an increment, adjust priorities, start the next round |
Common statuses
There are nine top-level task states:
| Status | Meaning | User action |
|---|---|---|
| created | Task created, not yet started preparing | Wait |
| preparing | Platform is organizing resources and context | Wait |
| running | Agent is executing the task | Monitor progress |
| waiting_approval | A pending approval request exists | Review risk and approve or reject |
| degraded | Some capabilities unavailable, task continues in limited mode | Monitor the degradation reason |
| verifying | Agent is verifying deliverables | Wait for verification to complete |
| completed | Task completed successfully | Review deliverables |
| failed | Task stopped due to an error | Check failure reason and retry or adjust resources |
| stopped | Task stopped by you or the platform | Review results, restart or duplicate the task |
"Needs input," "awaiting approval," and "ready to review" are not separate top-level task statuses — they're specific situations while a task is running, and usually correspond to the following real signals:
| What you see in the UI | Corresponding real signal | User action |
|---|---|---|
| Needs input | The task is still running, and the Agent needs you to provide additional information, resources, or permissions | Open the task and reply |
| Awaiting approval | The task is still running, and there's an approval request in the pending state | Review the risk and approve or reject |
| Ready to review | The task is still running or has just changed to completed, and has already produced inspectable deliverables | Review the deliverables |
An approval request is a separate object with its own state machine: pending, approved, rejected, expired — it is not part of the task status itself.
Status priority
The task view should prioritize showing:
- Tasks with a pending approval request (waiting_approval).
- Tasks that need you to provide additional information (running state, needs input).
- Tasks that have produced deliverables awaiting your review (ready to review).
- failed.
- degraded.
- running (other cases).
- verifying.
- completed.
- stopped (normal completion).
This way, users don't need to dig through a mass of logs to find what needs handling.
Viewing task details
Once you open a task, you can see:
- Goal summary.
- Current stage.
- Agent roles.
- Recent actions.
- Key logs.
- Resource access records.
- Model consumption.
- Pending approvals.
- Deliverables.
- Failure reason.
Replying to the Agent
When a task shows "needs input," you can reply with:
- Additional requirements.
- Changed priorities.
- A chosen approach.
- More uploaded or connected documents.
- Adjusted resource scope.
- A request to generate a plan first.
- A request to stop a certain direction.
Replies should be as specific as possible.
Not recommended:
Keep going.
Use your judgment.
Hurry up.Recommended:
For now, only implement user login and the project list; don't build the notifications module.
On the backend, only change the api/projects-related endpoints.
Don't access the production database.
Give me the test results first when done — don't deploy.Reviewing deliverables
Deliverables can include:
- Requirements documentation.
- Technical approach.
- Code diff.
- Test results.
- Build results.
- Deployment logs.
- Runtime URL.
- Audit records.
- Follow-up suggestions.
Before accepting, don't just look at the final one-liner — check the key artifacts.
Taking over a task
When a task is complex or needs human judgment, you can take it over.
After taking over, you can:
- View the full context.
- Reply directly with more detailed requirements.
- Adjust resource authorization.
- Split the task.
- Request re-planning.
- Stop the current execution.
Taking over doesn't mean giving up on the task. It just moves you from the overview view into a more detailed task conversation.
Stopping a task
Situations where you might stop a task:
- The goal was written incorrectly.
- The wrong resources were selected.
- The budget is abnormal.
- The Agent is clearly heading in the wrong direction.
- The task is stuck.
- A security risk has appeared.
- Execution is no longer needed.
After stopping a task, you should check:
- Whether there's uncommitted code.
- Whether there are temporary resources.
- Whether there's an unclosed deployment.
- Whether there are still-valid short-lived credentials.
- Whether the audit trail needs to be retained.
Re-running a task
Before re-running, it's recommended to adjust:
- The goal description.
- Resource scope.
- Agent roles.
- Budget.
- Approval rules.
- SK skills.
Don't repeatedly retry under the same failure conditions — it wastes model budget.
Last updated on