Band Band

Tasks Window

The Tasks window provides a centralized view of all coding agent tasks across your projects and workspaces. It opens as a dedicated native window from the Band desktop app, giving you a consolidated task management interface separate from the main dashboard.

Opening the Tasks Window

The Tasks window is accessed from the Band desktop app's menu. It opens as a separate 900x700 pixel window. If the window is already open, focusing it again simply brings it to the front. On macOS, it uses an overlay title bar for a clean, native appearance.

Task List

The main area displays all tasks as cards, sorted by most recent. Each task card shows:

  • Prompt — The text prompt that was submitted to the coding agent, displayed as the primary content of the card.
  • Status badge — A colored badge indicating the current state: Running (with spinner), Completed (green), or Failed (red).
  • Project and branch — Shown as project/branch to identify which workspace the task belongs to.
  • Timing — When the task started (relative time like "5m ago") and its duration.
  • Session link — If the task has an associated session, a link takes you to the workspace detail view where you can see the full agent output.

Filtering Tasks

The toolbar below the header provides two filter dropdowns:

  • Project filter — Show tasks from a specific project only, or All Projects.
  • Status filter — Show only tasks with a specific status: All Statuses, Running, Completed, or Failed.

A refresh button is available to manually reload the task list. The list also auto-refreshes every 5 seconds so it stays up to date.

Submitting a New Task

Click the New Task button to open the task submission dialog. The dialog has three fields:

  1. Project — Select the target project from a dropdown of all registered projects.
  2. Workspace — Select the target workspace (branch) within the chosen project.
  3. Prompt — Describe what the agent should do. This is the instruction text sent to the coding agent.

Once submitted, the task appears in the list with a Running status. You can also submit tasks via the CLI: 

band tasks create <workspace_id> --prompt "Fix the failing tests"

Canceling Tasks

Running tasks show a cancel button (X icon) on the right side of the task card. Clicking it sends a cancellation request to the agent. The task transitions to a failed state once the agent acknowledges the cancellation. 

band tasks cancel <task_id>

Re-running Tasks

Completed and failed tasks show a re-run button (rotate icon). Clicking it resubmits the same prompt to the same workspace, creating a fresh task execution. 

band tasks rerun <task_id>

Watching Task Output

While you cannot stream full agent output directly in the Tasks window, you can monitor a task's real-time output using the CLI: 

# Watch a specific task
band tasks watch <task_id>

# Watch the latest task for a workspace
band tasks watch --workspace <workspace_id>

The band tasks watch command streams task output to your terminal in real time, similar to tail -f.

Task Lifecycle

A task goes through the following states:

  1. Running — The coding agent is actively working on the prompt. The task card shows a spinning loader.
  2. Completed — The agent finished successfully. A green checkmark badge is shown.
  3. Failed — The agent encountered an error or was cancelled. A red alert badge is shown.

Completed and failed tasks remain in the list as history, allowing you to review what was done and re-run tasks if needed.