linear-projects-read
List and get Linear projects via CLI (read-only operations)
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.
| name | linear-projects-read |
|---|---|
| description | List and get Linear projects via CLI (read-only operations) |
| version | 1.0.0 |
| license | MIT |
| compatibility | opencode |
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_KEYset in<git-root>/.envor 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
--jsonoutput with tools likejq, the processed results are already visible to the user
Notes
- Project names support partial matching (case-insensitive)