🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ 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...

Versionv1.0.1
Downloads1,179
Stars⭐ 16
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

  • 0 = No priority
  • 1 = Urgent
  • 2 = High
  • 3 = Normal
  • 4 = Low
  • πŸ’‘ 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"