Files
coder/docs/reference/cli/task_status.md
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

2.6 KiB
Generated

task status

Show the status of a task.

Aliases:

  • stat

Usage

coder task status [flags]

Description

  - Show the status of a given task.:

     $ coder task status task1

  - Watch the status of a given task until it completes (idle or stopped).:

     $ coder task status task1 --watch

Options

--watch

Type bool
Default false

Watch the task status output. This will stream updates to the terminal until the underlying workspace is stopped.

-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|healthy]
Default state changed,status,healthy,state,message

Columns to display in table output.

-o, --output

Type table|json
Default table

Output format.