Files
coder/docs/reference/cli/task_create.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.5 KiB
Generated

task create

Create a task

Usage

coder task create [flags] [input]

Description

  - Create a task with direct input:

     $ coder task create "Add authentication to the user service"

  - Create a task with stdin input:

     $ echo "Add authentication to the user service" | coder task create

  - Create a task with a specific name:

     $ coder task create --name task1 "Add authentication to the user service"

  - Create a task from a specific template / preset:

     $ coder task create --template backend-dev --preset "My Preset" "Add authentication to the user service"

  - Create a task for another user (requires appropriate permissions):

     $ coder task create --owner user@example.com "Add authentication to the user service"

Options

--name

Type string

Specify the name of the task. If you do not specify one, a name will be generated for you.

--owner

Type string
Default me

Specify the owner of the task. Defaults to the current user.

--template

Type string
Environment $CODER_TASK_TEMPLATE_NAME

--template-version

Type string
Environment $CODER_TASK_TEMPLATE_VERSION

--preset

Type string
Environment $CODER_TASK_PRESET_NAME
Default none

--stdin

Type bool

Reads from stdin for the task input.

-q, --quiet

Type bool

Only display the created task's ID.

-O, --org

Type string
Environment $CODER_ORGANIZATION

Select which organization (uuid or name) to use.