---
name: tracker/linear-cli:team-list
description: List all accessible Linear teams using the linear CLI
version: "0.4.0"
---

# Team List

Retrieve all Linear teams accessible to the authenticated user to discover valid team keys for use in other primitives.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|

No parameters. Returns all teams accessible to the authenticated user.

## Implementation

```bash
linear team list
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| teams | object[] | Array of team summaries, each with id, key, name, and member count |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| AUTH_FAILED | API key is missing or invalid | Run `linear auth` to authenticate |
| VALIDATION_ERROR | Unexpected response format from the Linear API | Re-run `linear auth` to refresh credentials |

## Used By

- dev-task (discover available teams before creating issues or projects)
