---
name: tracker/linear-cli:issue-create
description: Create a Linear issue using the linear CLI
version: "0.4.0"
---

# Issue Create

Create a new issue in a Linear team with optional metadata fields including priority, labels, assignee, project, and cycle.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| title | string | Yes | Issue title |
| description | string | No | Issue body (markdown supported) |
| team | string | Yes | Team key or ID (e.g., `ENG`) |
| priority | string | No | Priority level: `urgent`, `high`, `medium`, `low`, `none` |
| label | string | No | Label name to apply; repeat flag for multiple |
| assignee | string | No | Assignee username or email |
| project | string | No | Project name or ID to associate the issue with |
| cycle | string | No | Cycle (sprint) name or ID to add the issue to |

## Implementation

```bash
linear issue create \
  --title "{title}" \
  --team "{team}" \
  {description ? `--description "{description}"` : ""} \
  {priority ? `--priority {priority}` : ""} \
  {label ? `--label "{label}"` : ""} \
  {assignee ? `--assignee "{assignee}"` : ""} \
  {project ? `--project "{project}"` : ""} \
  {cycle ? `--cycle "{cycle}"` : ""}
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| identifier | string | Human-readable issue ID (e.g., `ENG-123`) |
| url | string | Direct URL to the created issue |
| title | string | Confirmed title of the created issue |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| AUTH_FAILED | API key is missing or invalid | Run `linear auth` to authenticate |
| NOT_FOUND | Specified team, project, cycle, or assignee does not exist | Verify values with `linear team list` or `linear project list` |
| VALIDATION_ERROR | Required field missing or value is invalid | Check that `--title` and `--team` are provided and non-empty |

## Used By

- dev-task (create issues for planned work items)
