ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

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, manage projects, or search across your workspace. Calls api.linear.app directly with no third-party proxy.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/codeninja23/native-linear
Or

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

Metadata

Stars3453
Views0
Updated2026-03-26
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-codeninja23-native-linear": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills