名称： linearis
版本： 1.0.0
描述： Linear.app 命令行工具，用于问题追踪。支持列出、创建、更新和搜索 Linear 的问题、评论、文档、周期和项目。为 LLM 智能体优化，默认输出 JSON 格式。
元数据： {"clawdbot":{"emoji":"📋","requires":{"bins":["linearis"]},"install":[{"id":"npm","kind":"node","package":"linearis","bins":["linearis"],"label":"安装 linearis (npm)"}]}}

linearis

专为 LLM 智能体设计的 Linear.app 命令行工具，默认输出 JSON 格式。

安装与配置

npm install -g linearis

身份验证（任选其一）：
- echo "lin_api_..." > ~/.linear_api_token （推荐）
- export LINEAR_API_TOKEN="lin_api_..."
- 使用 --api-token <token> 参数

获取 API 密钥：Linear 设置 → 安全与访问 → 个人 API 密钥

命令概览

问题管理

linearis issues list -l 20              # 列出最近的问题
linearis issues list -l 10 --team WHO   # 按团队筛选
linearis issues search "bug"            # 全文搜索
linearis issues read ABC-123            # 获取问题详情
linearis issues create --title "修复 bug" --team WHO --priority 2
linearis issues update ABC-123 --status "已完成"
linearis issues update ABC-123 --title "新标题" --assignee user123
linearis issues update ABC-123 --labels "Bug,Critical" --label-by adding
linearis issues update ABC-123 --parent-ticket EPIC-100  # 设置父任务

评论管理

linearis comments create ABC-123 --body "已在 PR #456 中修复"

文档管理

linearis documents list
linearis documents list --project "后端"
linearis documents create --title "规格文档" --content "# 概述..."
linearis documents read <文档-id>
linearis documents update <文档-id> --content "已更新"
linearis documents delete <文档-id>

文件上传/下载

linearis embeds upload ./screenshot.png
linearis embeds download "<url>" --output ./file.png

团队、用户与项目管理

linearis teams list
linearis users list --active
linearis projects list
linearis cycles list --team WHO --active

完整使用说明

linearis usage  # 查看完整的命令参考（约 1000 词）

输出格式

所有命令默认返回 JSON 格式。可通过 jq 进行管道处理：

linearis issues list -l 5 | jq '.[].identifier'

优先级数值对照

• 0: 无优先级
• 1: 紧急
• 2: 高
• 3: 中
• 4: 低

相关链接

• 文档：https://github.com/czottmann/linearis
• 博客介绍：https://zottmann.org/2025/09/03/linearis-my-linear-cli-built.html