Native Linear

该工具通过Linear GraphQL API直接对接Linear平台，核心功能涵盖查询/管理团队、议题、项目、周期，支持查看个人/团队议题、搜索议题、创建/更新议题等。典型场景：查看个人在办任务、筛选团队待办、创建新需求、搜索特定bug等。需先配置LINEAR_API_KEY环境变量，通过Python脚本加参数的命令行调用，输出对应数据或操作反馈。

codeninja23

热度 69.56

最近更新 2026-05-11 17:26:52

分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：任务管理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add native-linear

Metadata

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)

Go to Linear → Settings → Account → Security & Access → API keys
Create a new key
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