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

2.5 KiB

Generated

Raw Blame History

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.

2.5 KiB Generated Raw Blame History