Linear
Interact with Linear directly via the Linear GraphQL API (api.linear.app/graphql).
Setup (one-time)
- Go to Linear → Settings → Account → Security & Access → API keys
- Create a new key
- Set environment variable:
text LINEAR_API_KEY=lin_api_...
Usage
List your teams
python3 /mnt/skills/user/linear/scripts/linear_query.py teams
List issues assigned to you
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues --state "In Progress"
List issues for a team
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering"
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering" --state "Todo" --limit 20
Get a specific issue
python3 /mnt/skills/user/linear/scripts/linear_query.py issue ENG-123
Search issues
python3 /mnt/skills/user/linear/scripts/linear_query.py search "authentication bug"
Create an issue
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Fix login bug" --description "Users can't log in on Safari"
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Add dark mode" --priority 2
Update an issue
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --state "Done"
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --priority 1 --title "New title"
List projects
python3 /mnt/skills/user/linear/scripts/linear_query.py projects
python3 /mnt/skills/user/linear/scripts/linear_query.py projects --team "Engineering"
List cycles (sprints)
python3 /mnt/skills/user/linear/scripts/linear_query.py cycles --team "Engineering"
List workflow states for a team
python3 /mnt/skills/user/linear/scripts/linear_query.py states --team "Engineering"
Priority levels
- 0 = No priority
- 1 = Urgent
- 2 = High
- 3 = Normal
- 4 = Low
