OpenSkillIndex← back to search
claude-codeproductivity

Marketplace linear-projects-read

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

install
source · Clone the upstream repo
git clone https://github.com/aiskillstore/marketplace
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bind/linear-projects-read" ~/.claude/skills/aiskillstore-marketplace-linear-projects-read && rm -rf "$T"
manifest: skills/bind/linear-projects-read/SKILL.md
tags
#linear#cli#project-management#api#read-only
source content

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)