Linear

Linear Skill

CLI tools for interacting with Linear. All scripts are in ./scripts/ and use the @linear/sdk package. Requires LINEAR_AGENT_API_KEY env var.

Setup

Install dependencies (only needed once):

cd ./scripts && npm install

Current User

./scripts/me.js

Shows your user info, organization, and teams.

Teams

./scripts/teams.js

Users

./scripts/users.js

Workflow States (Statuses)

./scripts/states.js
./scripts/states.js --team ENG

List available statuses per team (e.g. Backlog, Todo, In Progress, Done, Canceled).

Labels

./scripts/labels.js
./scripts/labels.js --team ENG

List Issues

./scripts/issues.js --team ENG
./scripts/issues.js --assignee me --status "In Progress"
./scripts/issues.js --team ENG --cycle current
./scripts/issues.js --label bug --priority 1
./scripts/issues.js --project "API Redesign" --limit 20
./scripts/issues.js --team ENG --json

Filters: --team, --assignee me, --status, --label, --priority , --project, --cycle current, --limit, --json.

Get Issue Details

./scripts/issue-get.js ENG-123

Shows full issue details including description, comments, relations, and metadata.

Search Issues

./scripts/issue-search.js "login bug"
./scripts/issue-search.js authentication error

Full-text search across issue titles, descriptions, and comments.

Create Issue

./scripts/issue-create.js --team ENG --title "Fix login bug" --priority 1
./scripts/issue-create.js --team ENG --title "New feature" --description "Details here" --assignee me --label feature
./scripts/issue-create.js --team ENG --title "Sub-task" --parent ENG-100 --status "In Progress"

Required: --team, --title. Optional: --description, --status, --priority , --assignee me|, --label (repeatable), --estimate, --project, --parent, --due .

Update Issue

./scripts/issue-update.js ENG-123 --status "In Progress"
./scripts/issue-update.js ENG-123 --assignee me --priority 2
./scripts/issue-update.js ENG-123 --status Done
./scripts/issue-update.js ENG-123 --label-add bug --label-rm feature
./scripts/issue-update.js ENG-123 --assignee none
./scripts/issue-update.js ENG-123 --due 2025-03-15

Options: --title, --description, --status, --priority , --assignee me||none, --label-add, --label-rm, --estimate, --project, --parent, --due |none.

Add Comment

./scripts/comment.js ENG-123 "This is fixed in the latest deploy"

Comments support markdown.

Projects

./scripts/projects.js
./scripts/projects.js --status started
./scripts/projects.js --team ENG --json

Filters: --status, --team, --limit, --json.

Cycles

./scripts/cycles.js --team ENG
./scripts/cycles.js --current

Filters: --team, --current, --limit.

Priority Values

| Value | Meaning | |-------|---------| | 0 | None | | 1 | Urgent | | 2 | High | | 3 | Medium | | 4 | Low |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: NelsonBrandao
• Source: NelsonBrandao/pi-agent-extensions
• License: MIT

Install and usage instructions live in the source repository linked above.