π¦ ClawHub
Native Linear
by @codeninja23
Query and manage Linear issues, projects, cycles, and teams via the Linear GraphQL API. Use when you need to list or create issues, check cycle status, manag...
TERMINAL
clawhub install native-linearπ About This Skill
name: linear description: "Query and manage Linear issues, projects, cycles, and teams via the Linear GraphQL API. Use when you need to list or create issues, check cycle status, manage projects, or search across your workspace. Calls api.linear.app directly with no third-party proxy." metadata: openclaw: requires: env: - LINEAR_API_KEY bins: - python3 primaryEnv: LINEAR_API_KEY files: - "scripts/*"
Linear
Interact with Linear directly via the Linear GraphQL API (api.linear.app/graphql).
Setup (one-time)
1. Go to Linear β Settings β Account β Security & Access β API keys 2. Create a new key 3. Set environment variable:
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
π‘ Examples
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"