linear-issues-read

List and retrieve Linear issues with filters for team, project, assignee, and status.

5|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/Bind/skillz.sh --skill linear-issues-read
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-issues-read
Source: https://github.com/Bind/skillz.sh/tree/main/docs/registry/skills/linear-issues-read
Command: npx skills add https://github.com/Bind/skillz.sh --skill linear-issues-read

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @linear/sdk.

What problem does it solve?

This skill enables reading Linear issues directly from the command line, eliminating tedious context-switching and manual lookups when tracking work in Linear.

Core Features & Use Cases

  • List issues by team, project, assignee, and status to surface work items quickly.
  • Retrieve a single issue by ID to inspect details without leaving the terminal.
  • Filter results and output in JSON to feed dashboards, reports, or automation scripts.

Quick Start

Install and run the skill using the Linear API key. For examples: bun .opencode/skill/linear-issues-read/list-issues.js --team Engineering --limit 10 bun .opencode/skill/linear-issues-read/get-issue.js ENG-123 Ensure LINEAR_API_KEY is available in your <git-root>/.env or environment.

Frequently Asked Questions about linear-issues-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list Linear issues from the command line?

You can list Linear issues from the command line by running the list-issues.js script with Bun and applying filters like --team, --project, --assignee, and --status to retrieve targeted results directly in your terminal.

How do I get a single Linear issue by ID using the CLI?

To get a single Linear issue by ID, execute the get-issue.js script using Bun and pass the issue identifier, such as ENG-123, as an argument to output its full details without leaving the terminal.

Do I need a Linear API key to read issues from the CLI?

Yes, reading Linear issues requires a Linear API key. You must set the LINEAR_API_KEY environment variable or place it in your git root .env file to authenticate the Linear SDK requests.

Can I filter Linear issues by team and project when retrieving them?

Yes, you can filter Linear issues by team, project, assignee, and status. This allows you to quickly surface specific work items and output the filtered results in JSON format for dashboards or automation scripts.