---
name: tracker/linear-cli:issue-list
description: List Linear issues with optional filters using the linear CLI
version: "0.4.0"
---

# Issue List

Retrieve a filtered list of Linear issues for a team, optionally narrowed by state, assignee, label, and result count.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| team | string | No | Team key or ID to filter by (e.g., `ENG`) |
| state | string | No | Workflow state name to filter by (e.g., `In Progress`, `Todo`) |
| assignee | string | No | Assignee username or email to filter by |
| label | string | No | Label name to filter by |
| limit | number | No | Maximum number of results to return (default: 25) |

## Implementation

```bash
linear issue list \
  {team ? `--team "{team}"` : ""} \
  {state ? `--state "{state}"` : ""} \
  {assignee ? `--assignee "{assignee}"` : ""} \
  {label ? `--label "{label}"` : ""} \
  {limit ? `--limit {limit}` : ""}
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| issues | object[] | Array of issue summaries, each with identifier, title, state, assignee, priority, and URL |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| AUTH_FAILED | API key is missing or invalid | Run `linear auth` to authenticate |
| NOT_FOUND | Specified team or filter value does not exist | Verify team key with `linear team list` |
| VALIDATION_ERROR | Filter value is malformed | Check parameter spelling and casing |

## Used By

- dev-task (review existing issues before creating new ones)
- deploy-status (surface in-progress and blocked issues)
