linear

name	linear
description	Linear issue management (search, create, update, close, comment) with arbitrary GraphQL queries.

Linear

Direct Linear GraphQL API access via Bun CLI. Zero external dependencies.

Two script variants:

Script	Size	Use Case
scripts/linear.ts	~120 lines	Standard: setup + api, agent constructs queries using api.md
scripts/linear-issue.ts	~570 lines	Issue-specific: wraps search/create/update/list/comment as named commands

Setup

Check if config.json exists in this directory:

• Exists → use directly
• Missing → ensure LINEAR_API_KEY env var is set (Linear Settings → API → Personal API Keys), then run:

bun <skill-dir>/scripts/linear.ts setup
# or (full version)
bun <skill-dir>/scripts/linear-issue.ts setup

Config structure:

{ "apiKey": "$LINEAR_API_KEY", "teamKey": "YOUR_TEAM_KEY" }

• apiKey: API key or env var reference ($LINEAR_API_KEY)
• teamKey: Linear team key (e.g. WOR)

Issue Commands (linear-issue.ts)

Command	Purpose
setup	Interactive config.json initialization
search <query>	Search issues by keyword
list [--state <name>] [--project <slug>]	List issues
create --title "..." [--body "..." | --body-file path] [--template feat]	Create issue
update <id> [--parent <id>] [--state <name>]	Update issue
comment <id> [--body "..." | --body-file path]	Add comment
teams / templates / states	Query workspace metadata
api '<graphql>' [--vars '<json>']	Arbitrary GraphQL query

Standard Commands (linear.ts)

Command	Purpose
setup	Initialize config.json
api '<graphql>' [--vars '<json>']	Arbitrary GraphQL query

Use --body-file for multi-line body (write to temp file) to avoid shell escaping issues.

See references/api.md for query examples and detailed usage.