Task Queue Visibility

The Task Queue panel provides real-time visibility into agent work within your sessions. Track task progress, view errors, and manage the work queue directly from your workspace.

Overview

When agents work on your project, they create tasks representing discrete units of work. The Task Queue panel displays these tasks with their current status, allowing you to:

• Monitor work in progress
• Identify blocked or failed tasks
• Cancel pending tasks
• Retry failed tasks

Task Status Types

Tasks progress through several status states:

Status	Description	Actions Available
Pending	Queued for execution	Cancel
Running	Currently being processed	Cancel
Completed	Successfully finished	None
Failed	Encountered an error	Retry
Cancelled	Manually stopped	Retry

Using the Task Queue Panel

Viewing Tasks

The panel displays:

• Header with total task count and refresh button
• Status badges showing counts by status (Running, Pending, Failed, Completed)
• Task list with individual task details

Filtering by Status

Click any status badge to filter the task list:

• Click "Running" to see only running tasks
• Click the same badge again to clear the filter

Task Details

Each task item shows:

• Title describing the work
• Status badge indicating current state
• Story ID (if linked to a user story)
• Error message (for failed tasks)

Managing Tasks

Cancel a task:

Locate the pending or running task

Click the "X" button on the right

The task moves to cancelled status

Retry a failed task:

Find the failed task showing the error message

Click the retry (arrow) button

The task is re-queued as pending

Refresh the queue:

Click the refresh button in the panel header to fetch the latest task status.

Task Queue Badges

When you have active work, compact badges appear showing:

• Running count (blue)
• Pending count (yellow)
• Failed count (red)

These badges provide at-a-glance status without opening the full panel.

Session Scope

By default, the Task Queue shows tasks for your active session. Tasks from other sessions in the same project are not displayed. This keeps the view focused on your current work context.

Troubleshooting

"Loading tasks..." persists

Check your network connection and ensure the API is reachable. Try the refresh button.

Tasks not updating

Task status updates may take a moment to propagate. Click refresh to fetch the latest state.

Failed task with no error message

Some failures may not include detailed messages. Check the agent session logs for more context.

Related Topics

• Session Navigation - Managing agent sessions
• Organization and Project Switching - Context switching