linear-projects-read

Bind's avatarfrom Bind

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

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

The Linear Projects Read skill provides a powerful CLI-based integration for accessing Linear project data. It enables users to list and retrieve project details through read-only operations, supporting advanced filtering by status, project lead, and result limits. Designed for efficiency, it allows teams to query their project management workspace directly within the Claude environment, facilitating faster data retrieval and better project visibility without leaving the workflow.

Use Cases

  • Project Status Monitoring: Quickly list all projects with a 'started' or 'planned' status to assess current team velocity and upcoming priorities.
  • Resource Management: Filter projects by project lead to identify the workload distribution across specific team members.
  • Automated Reporting: Use the JSON output option to extract project metadata for use in external status reports, dashboards, or documentation.
  • Quick Project Lookup: Search for specific project details using partial name matching to find project IDs, descriptions, and current progress instantly.
namelinear-projects-read
descriptionList and get Linear projects via CLI (read-only operations)
version1.0.0
licenseMIT
compatibilityopencode

Overview

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

Prerequisites

  • bun runtime installed
  • LINEAR_API_KEY set in <git-root>/.env or environment

Commands

List Projects

bun .opencode/skill/linear-projects-read/list-projects.js [options]

Options:

  • --status <status> - Filter by status (planned, started, paused, completed, canceled)
  • --lead <name> - Filter by project lead name
  • --limit <n> - Max results (default: 25)
  • --json - Output as JSON

Examples:

bun .opencode/skill/linear-projects-read/list-projects.js --limit 10
bun .opencode/skill/linear-projects-read/list-projects.js --status started
bun .opencode/skill/linear-projects-read/list-projects.js --lead "James Madison" --json

Get Project

bun .opencode/skill/linear-projects-read/get-project.js <project-id-or-name> [options]

Arguments:

  • project-id-or-name - Project UUID or name (partial match supported)

Options:

  • --json - Output as JSON

Examples:

bun .opencode/skill/linear-projects-read/get-project.js "Mount Vernon"
bun .opencode/skill/linear-projects-read/get-project.js "Monticello" --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

  • Project names support partial matching (case-insensitive)