mirror of https://github.com/coder/coder.git synced 2026-06-03 04:58:23 +00:00

Files

T

Mathias Fredriksson ad8ba4aac6 feat(cli): promote tasks commands from experimental to GA (#20916 )

## Overview

This change promotes the tasks CLI commands from `coder exp task` to
`coder task`, marking them as generally available (GA).

## Migration

Users will need to update their scripts from:

```shell
coder exp task create "my task"
```

To:
```shell
coder task create "my task"
```

---

🤖 This change was written by Claude Sonnet 4.5 Thinking using [mux](https://github.com/coder/mux) and reviewed by a human 🏄🏻‍♂️

2025-11-25 13:50:22 +00:00

3.3 KiB

Generated

Raw Permalink Blame History

task list

List tasks

Aliases:

Usage

coder task list [flags]

Description

  - List tasks for the current user.:

     $ coder task list

  - List tasks for a specific user.:

     $ coder task list --user someone-else

  - List all tasks you can view.:

     $ coder task list --all

  - List all your running tasks.:

     $ coder task list --status running

  - As above, but only show IDs.:

     $ coder task list --status running --quiet

Options

--status


Type	`pending\|initializing\|active\|paused\|error\|unknown`

Filter by task status.

-a, --all


Type	`bool`
Default	`false`

List tasks for all users you can view.

--user


Type	`string`

List tasks for the specified user (username, "me").

-q, --quiet


Type	`bool`
Default	`false`

Only display task IDs.

-c, --column


Type	`[id\|organization id\|owner id\|owner name\|owner avatar url\|name\|display name\|template id\|template version id\|template name\|template display name\|template icon\|workspace id\|workspace name\|workspace status\|workspace build number\|workspace agent id\|workspace agent lifecycle\|workspace agent health\|workspace app id\|initial prompt\|status\|state\|message\|created at\|updated at\|state changed]`
Default	`name,status,state,state changed,message`

Columns to display in table output.

-o, --output


Type	`table\|json`
Default	`table`

Output format.

3.3 KiB Generated Raw Permalink Blame History