> ## Documentation Index
> Fetch the complete documentation index at: https://docs.median.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# mdn create

> Create new tasks.

## Usage

```bash theme={null}
mdn create [flags]
```

`mdn create` uses the workspace selected by the nearest `.median/config.json`. If no project-local config exists, it uses your global default profile.

Run without flags for interactive mode. Use flags for scripted usage.

## Flags

| Flag                    | Short | Description        | Default      |
| ----------------------- | ----- | ------------------ | ------------ |
| `--title <text>`        | `-t`  | Task title         | *(required)* |
| `--description <text>`  | `-d`  | Task description   | *(none)*     |
| `--status <status>`     | `-s`  | Initial status     | `todo`       |
| `--priority <priority>` | `-p`  | Priority           | `medium`     |
| `--label <label>`       | `-l`  | Label (repeatable) | *(none)*     |
| `--agent <name>`        |       | Agent identifier   | *(none)*     |

## Examples

```bash theme={null}
# Interactive mode
mdn create

# With flags
mdn create --title "Fix login bug" --priority urgent --label bug

# Agent creating a task
mdn create --title "Refactor auth module" --priority high --agent claude-code

# Multiple labels
mdn create --title "Add dark mode" --label feature --label ui
```

## Output

```
  ✓ Created MED-45: Fix login bug ⚡ claude-code
```

## Valid values

**Statuses:** `requests` | `todo` | `in_progress` | `ready` | `shipped` | `archive`

**Priorities:** `urgent` | `high` | `medium` | `low` | `none`