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

# Project List

Retrieve all projects associated with a Linear team to identify available targets for issue association.

## Parameters

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

## Implementation

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

## Output

| Field | Type | Description |
|-------|------|-------------|
| projects | object[] | Array of project summaries, each with id, name, state, and URL |

## 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 (select a project when creating or organizing issues)
