linear-cli

name	linear-cli
description	Linear workspace CLI — issues, projects, documents, teams, users, comments, labels, cycles, milestones, attachments.

SKILL_DIR: This skill directory

Usage

• Windows: python ${SKILL_DIR}$/scripts/linear_cli.py <cmd> [flags]
• macOS/Linux: python3 ${SKILL_DIR}$/scripts/linear_cli.py <cmd> [flags]

Commands

Issues

get-issue --id ID # ID = identifier (e.g. PRJ-42) or UUID list-issues [--team NAME] [--state NAME] [--assignee NAME] [--label NAME] [--project NAME] [--priority INT] [--parent-id ID] [--filter JSON] create-issue --title STR --team-id UUID [--description MD] [--priority 0-4] [--assignee-id UUID] [--label-ids csv] [--state-id UUID] [--estimate INT] [--due-date YYYY-MM-DD] [--project-id UUID] [--cycle-id UUID] [--parent-id UUID] update-issue --id ID --input JSON # e.g. --input '{"title":"New","priority":2,"stateId":"...","assigneeId":"..."}' list-sub-issues --id ID # list child issues of a parent issue add-sub-issue --parent-id ID --issue-id ID # link existing issue as sub-issue remove-sub-issue --issue-id ID # unlink sub-issue from parent

Documents

get-document --id ID list-documents create-document --title STR --content MD (--project-id UUID|--issue-id UUID|--team-id UUID) update-document --id ID --input JSON # e.g. --input '{"title":"New","content":"..."}'

Projects

get-project (--id ID|--name STR) list-projects [--team NAME] [--state STATE] [--lead NAME] [--filter JSON] save-project --input JSON [--id UUID] # e.g. --input '{"name":"P","teamIds":["UUID"]}'

Teams

get-team (--id ID|--name STR) list-teams

Users

get-user (--id UUID|--name STR|--email STR|--me) list-users [--name STR] [--email STR]

Comments

list-comments --issue-id ID save-comment --input JSON [--id UUID] # create: '{"issueId":"...","body":"..."}' / update: '{"body":"..."}' delete-comment --id UUID

Labels

list-issue-labels [--team NAME] create-issue-label --name STR [--color HEX] [--team-id UUID] [--description STR] list-project-labels

Workflow

get-issue-status (--id UUID|--team NAME) list-issue-statuses (--team UUID|--name NAME) # --team expects UUID, --name expects team name save-issue-status --input JSON [--id UUID] # create: '{"name":"Review","teamId":"UUID","type":"started","color":"#f0ad4e"}' / update: '{"name":"Renamed"}' delete-issue-status --id UUID # archives the workflow state list-cycles (--team UUID|--name NAME)

Milestones

get-milestone (--id UUID|--project NAME) list-milestones (--project UUID|--name NAME) # --project expects UUID, --name expects project name save-milestone --input JSON [--id UUID] # e.g. --input '{"name":"M1","projectId":"UUID"}'

Attachments

get-attachment --id UUID create-attachment --issue-id UUID --url URL [--title STR] [--subtitle STR] delete-attachment --id UUID upload-file --file PATH # upload local file, returns assetUrl for use in descriptions/comments download-file --url URL [--output PATH] # download files uploaded in descriptions/comments (uploads.linear.app)

Notes

• save-* with --id updates, without --id creates.
• --input/--filter follows Linear GraphQL schema (IssueUpdateInput, ProjectFilter, etc.).
• --filter example: --filter '{"team":{"name":{"eq":"Backend"}},"priority":{"gte":2}}'
• Sub-issues: use --parent-id on create-issue, or add-sub-issue to link/create. get-issue returns parent and children fields.
• Priority: 0=None 1=Urgent 2=High 3=Normal 4=Low
• Project state: planned|started|paused|completed|canceled
• Workflow state type: backlog|unstarted|started|completed|canceled
• Errors: JSON to stderr {"error":"...","details":...}
• Workflow: first call list-teams to get team IDs/names, then use them in other commands.