By name: linear-tasks description: Linear issue tracking and project management. Use for creating issues, searching issues, getting issue details, and managing tasks in Linear. allowed-tools: Bash(python *)
Linear Issue Tracking
Authentication
Set the LINEAR_API_KEY environment variable with a Linear API key (from Settings > API).
Priority Levels
| Value | Level |
|---|---|
| 0 | No priority |
| 1 | Urgent |
| 2 | High |
| 3 | Medium |
| 4 | Low |
Available Scripts
All scripts are in .claude/skills/linear-tasks/scripts/
create_issue.py - Create Issue
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix bug" [--description "..."] [--priority 2]
# Examples:
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix auth timeout" --description "Users report 504 on login" --priority 2
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Update docs" --team-id TEAM_UUID
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Security review" --priority 1 --labels "security,urgent"
list_issues.py - List/Search Issues
python .claude/skills/linear-tasks/scripts/list_issues.py [--state "In Progress"] [--max-results 50]
# Examples:
python .claude/skills/linear-tasks/scripts/list_issues.py
python .claude/skills/linear-tasks/scripts/list_issues.py --state "In Progress"
python .claude/skills/linear-tasks/scripts/list_issues.py --state "Todo" --max-results 20
Client Library Functions
The linear_client.py module provides a GraphQL client:
| Function | Purpose |
|---|---|
graphql_request(query, variables) |
Execute any GraphQL query against Linear |
create_issue(title, description, ...) |
Create a new issue |
search_issues(query) |
Search issues by text |
get_issue(issue_id) |
Get issue details by identifier |
Common Workflows
1. Create a Task from a Conversation
python create_issue.py --title "Update refund policy docs" \
--description "Customer asked about refund timeline — docs are outdated" \
--priority 3
2. Check Team Workload
python list_issues.py --state "In Progress"
3. Find Related Issues
python list_issues.py --state "Todo" --max-results 100
Quick Reference
| Goal | Command |
|---|---|
| Create issue | create_issue.py --title "Title" --priority 2 |
| List open issues | list_issues.py --state "In Progress" |
| List all issues | list_issues.py --max-results 100 |