Native Linear

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

codeninja23

@codeninja23

What This Skill Does

Command-line tool that queries and manages Linear issues, projects, cycles, and teams via the Linear GraphQL API. Supports listing, creating, updating, and searching issues, as well as retrieving team, project, and cycle data.

Replaces manual Linear UI navigation and browser-based issue management by exposing all core Linear operations through a single CLI with consistent flags.

When to Use It

  • List all issues assigned to you across teams
  • Create a new issue with title, description, and priority
  • Search your Linear workspace for issues matching a keyword
  • Update an issue's status to Done or change its priority
  • View current cycle (sprint) status for a specific team
  • List all projects under a given team

Install

$ openclaw skills install @codeninja23/native-linear

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

Top skills in this category