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

# Project Create

Create a new Linear project within a team to group related issues and track delivery milestones.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | Yes | Project display name |
| team | string | Yes | Team key or ID to own the project (e.g., `ENG`) |
| description | string | No | Project description (markdown supported) |

## Implementation

```bash
linear project create \
  --name "{name}" \
  --team "{team}" \
  {description ? `--description "{description}"` : ""}
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| id | string | Internal UUID of the created project |
| name | string | Confirmed project display name |
| url | string | Direct URL to the created project |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| AUTH_FAILED | API key is missing or invalid | Run `linear auth` to authenticate |
| NOT_FOUND | Specified team does not exist | Verify team key with `linear team list` |
| VALIDATION_ERROR | Required field missing or project name is already in use | Check that `--name` and `--team` are provided and that the name is unique |

## Used By

- dev-task (create a project to house a new work stream before creating issues)
