---
name: tracker/linear-cli:label-list
description: List available labels for a Linear team using the linear CLI
version: "0.4.0"
---

# Label List

Retrieve all labels defined in a Linear team to identify valid label names for use when creating or updating issues.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| team | string | No | Team key or ID to filter labels by (e.g., `ENG`) |

## Implementation

```bash
linear label list \
  {team ? `--team "{team}"` : ""}
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| labels | object[] | Array of label objects, each with id, name, and color |

## 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 | Team value is malformed | Check team key format (e.g., `ENG`) |

## Used By

- dev-task (enumerate valid label names before applying them to new issues)
