---
layout: commands
page_title: 'Commands: Task list'
sidebar_title: 'task list'
description: 'List all On-Demand Runner Tasks in Waypoint'
---

# Waypoint Task list

Command: `waypoint task list`

List all On-Demand Runner Tasks in Waypoint

@include "commands/task-list_desc.mdx"

## Usage

Usage: `waypoint task list [options]`

List all known On-Demand Runner Tasks from Waypoint server. Each task is a
Waypoint Job tuple made up of a StartTask, RunTask, and StopTask.

#### Global Options

- `-plain` - Plain output: no colors, no animation. The default is false.
- `-app=<string>` (`-a`) - App to target. Certain commands require a single app target for Waypoint configurations with multiple apps. If you have a single app, then this can be ignored.
- `-project=<string>` (`-p`) - Project to target.
- `-workspace=<string>` (`-w`) - Workspace to operate in.

#### Operation Options

- `-label=<key=value>` - Labels to set for this operation. Can be specified multiple times.
- `-local` - True to use a local runner to execute the operation, false to use a remote runner.
  If unset, Waypoint will automatically determine where the operation will occur,
  defaulting to remote if possible.
- `-remote-source=<key=value>` - Override configurations for how remote runners source data. This is specified to the data source type being used in your configuration. This is used for example to set a specific Git ref to run against.
- `-var=<key=value>` - Variable value to set for this operation. Can be specified multiple times.
- `-var-file=<string>` - HCL or JSON file containing variable values to set for this operation. If any "_.auto.wpvars" or "_.auto.wpvars.json" files are present, they will be automatically loaded.

#### Command Options

- `-desc` - Output the list of Tasks from newest to oldest. The default is false.
- `-json` - Output the list of Tasks as json. The default is false.
- `-limit=<int>` - If set, will limit the number of Tasks to list.
- `-state=<string>` - List Tasks that only match the requested state. Can be repeated multiple times. One possible value from: UNKNOWN, PENDING, STARTING, STARTED, RUNNING, COMPLETED, STOPPING, STOPPED, MIXED.

@include "commands/task-list_more.mdx"
