---
name: aiskillstore-linear-issues-read
description: "List and get Linear issues via CLI (read-only operations)"
license: "MIT"
metadata:
  decimalai-skill-id: "7905ba1d-8faf-4ad7-8618-25bd850afc31"
  decimalai-version-id: "9c36d6c9-96dc-4436-91de-0ef2ba35ae54"
  decimalai-version: "1"
  decimalai-body-sha256: "53451134bd18d959ff55284028ccd5c8cfaf6e9d6fcb097222fc0947ca7d666b"
  decimalai-name: "aiskillstore/linear-issues-read"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "productivity"
  decimalai-source: "https://app.decimal.ai/s/aiskillstore-linear-issues-read@1/SKILL.md"
---
## Overview

CLI tools for reading Linear issues. Requires `LINEAR_API_KEY` set in `<git-root>/.env` or exported in the environment.

## Prerequisites

- [bun](https://bun.sh) runtime installed
- `LINEAR_API_KEY` set in `<git-root>/.env` or environment

## Commands

### List Issues

```bash
bun .opencode/skill/linear-issues-read/list-issues.js [options]
```

**Options:**
- `--team <name>` - Filter by team (e.g., Engineering, Infrastructure, Product)
- `--project <name>` - Filter by project name
- `--assignee <name>` - Filter by assignee name
- `--status <status>` - Filter by status (e.g., "In Progress", "Todo", "Done")
- `--limit <n>` - Max results (default: 25)
- `--json` - Output as JSON

**Examples:**
```bash
bun .opencode/skill/linear-issues-read/list-issues.js --team Engineering --limit 10
bun .opencode/skill/linear-issues-read/list-issues.js --assignee "George Washington" --status "In Progress"
bun .opencode/skill/linear-issues-read/list-issues.js --project "Mount Vernon" --json
```

---

### Get Issue

```bash
bun .opencode/skill/linear-issues-read/get-issue.js <issue-id> [options]
```

**Arguments:**
- `issue-id` - Issue identifier (e.g., ENG-123) or UUID

**Options:**
- `--json` - Output as JSON

**Examples:**
```bash
bun .opencode/skill/linear-issues-read/get-issue.js ENG-123
bun .opencode/skill/linear-issues-read/get-issue.js ENG-123 --json
```

---

## Output Behavior

- Command output is displayed directly to the user in the terminal
- **Do not re-summarize or reformat table output** - the user can already see it
- Only provide additional commentary if the user explicitly requests analysis, filtering, or summarization
- When using `--json` output with tools like `jq`, the processed results are already visible to the user

## Notes

- Team, user, and label names are resolved automatically (case-insensitive)