Band Band

band tasks

The band tasks command group manages tasks within workspaces. A task represents a unit of work assigned to an AI agent. Each task has a prompt, runs inside a workspace, and produces a stream of agent activity (tool calls, file edits, and chat messages).

List Tasks

Display all tasks, optionally filtered by workspace or status.

band tasks list

Example output:

ID   Workspace        Prompt                          Status     Duration
1    fix-auth-bug     Fix the login timeout issue      completed  3m 42s
2    add-dark-mode    Add dark mode toggle to sett...  running    1m 15s
3    refactor-api     Extract middleware into sepa...  pending    —
4    fix-auth-bug     Update test fixtures             cancelled  —

Create a Task

Submit a new task to a workspace. The agent will begin executing the task prompt immediately if no other task is running in that workspace. 

band tasks create --workspace 1 --prompt "Fix the login timeout issue by increasing the session TTL to 24 hours"

Options:

  • --workspace <id> — The workspace ID to run the task in (required).
  • --prompt "..." — The task description for the agent (required).

Cancel a Task

Cancel a running or pending task. The agent process will be stopped and the task marked as cancelled. 

band tasks cancel 2

Rerun a Task

Rerun a previously completed or cancelled task. This creates a new task with the same prompt in the same workspace. 

band tasks rerun 1

Watch a Task

Stream real-time output from a running task to your terminal. This displays agent activity as it happens, including tool calls, file edits, and chat messages. 

band tasks watch 2

The watch command connects via WebSocket and streams updates until the task completes. Press Ctrl+C to stop watching without cancelling the task.

JSON Output

band tasks list --output json

Example JSON output:

[
  {'{'}
    "id": 1,
    "workspaceId": 1,
    "prompt": "Fix the login timeout issue",
    "status": "completed",
    "durationMs": 222000,
    "createdAt": "2025-12-01T10:30:00Z"
  {'}'}
]

Task Lifecycle

  • pending — Task is queued and waiting for the agent to start.
  • running — Agent is actively working on the task.
  • completed — Agent finished the task successfully.
  • cancelled — Task was cancelled by the user.
  • failed — Agent encountered an unrecoverable error.