# Linear Issues Read

> Linear Issues Read is an Agent Skill for apps & automation published in the aiskillstore/marketplace repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

List and get Linear issues via CLI (read-only operations)

- Skill name: `linear-issues-read`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/aiskillstore/marketplace/blob/HEAD/skills/bind/linear-issues-read/SKILL.md
- Repository: aiskillstore/marketplace (385 GitHub stars when collected)

## 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)

---

Source: https://www.openparable.com/skill/apps-automation/linear-issues-read (OpenParable). Cite the canonical URL above.
