| 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]
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]
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 |
