mirror of
https://github.com/coder/coder.git
synced 2026-06-03 13:08:25 +00:00
Mathias Fredriksson
ad8ba4aac6
## 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 🏄🏻♂️
93 lines
3.3 KiB
Markdown
Generated
93 lines
3.3 KiB
Markdown
Generated
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
|
# task list
|
|
|
|
List tasks
|
|
|
|
Aliases:
|
|
|
|
* ls
|
|
|
|
## Usage
|
|
|
|
```console
|
|
coder task list [flags]
|
|
```
|
|
|
|
## Description
|
|
|
|
```console
|
|
- 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 | <code>pending\|initializing\|active\|paused\|error\|unknown</code> |
|
|
|
|
Filter by task status.
|
|
|
|
### -a, --all
|
|
|
|
| | |
|
|
|---------|--------------------|
|
|
| Type | <code>bool</code> |
|
|
| Default | <code>false</code> |
|
|
|
|
List tasks for all users you can view.
|
|
|
|
### --user
|
|
|
|
| | |
|
|
|------|---------------------|
|
|
| Type | <code>string</code> |
|
|
|
|
List tasks for the specified user (username, "me").
|
|
|
|
### -q, --quiet
|
|
|
|
| | |
|
|
|---------|--------------------|
|
|
| Type | <code>bool</code> |
|
|
| Default | <code>false</code> |
|
|
|
|
Only display task IDs.
|
|
|
|
### -c, --column
|
|
|
|
| | |
|
|
|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| Type | <code>[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]</code> |
|
|
| Default | <code>name,status,state,state changed,message</code> |
|
|
|
|
Columns to display in table output.
|
|
|
|
### -o, --output
|
|
|
|
| | |
|
|
|---------|--------------------------|
|
|
| Type | <code>table\|json</code> |
|
|
| Default | <code>table</code> |
|
|
|
|
Output format.
|