LLM 原生的 Linear 命令行

专为 LLM 代理优化的 Linear 项目管理 CLI，支持 JSON 输出实现问题追踪、文档管理与工作流自动化。

基本信息

• 技能名称?Linearis
• 中文名称?LLM 原生的 Linear 命令行
• 作者?whoisnnamdi
• 分类?专业技能
• 版本?1.0.0
• 标签?linear, cli, project-management, issue-tracking, json-api, automation, agile, npm

使用方法

使用说明
核心功能
linearis 是针对 Linear.app 设计的命令行工具，专为 LLM 代理场景优化，所有命令默认返回 JSON 格式输出，便于程序化解析和自动化处理。
主要能力覆盖
| 模块 | 支持操作 | |------|---------| | Issues | 列出、搜索、创建、更新（状态/标题/负责人/标签/父任务） | | Comments | 为问题添加评论 | | Documents | 项目文档的 CRUD 全生命周期管理 | | Embeds | 文件上传下载 | | 组织结构 | 团队、用户、项目、迭代周期查询 | 显著优点

1. LLM 原生设计 ：JSON 优先输出，无需解析人类可读格式，降低 token 消耗
2. 完整工作流覆盖 ：从问题创建到归档、从文档撰写到附件管理，一站式支持
3. 灵活的认证方式 ：支持文件存储、环境变量或命令行传参

4. 批量操作友好 ：配合 jq 可实现复杂的管道处理
   潜在局限
   Node.js 依赖 ：需 npm 环境，对纯 Python/Go 生态的代理不够轻量
   仅支持个人 API Token ：暂不支持 OAuth 应用级别的组织授权
   更新标签的语义复杂度 ： --label-by adding/removing 需要额外理解操作模式
   无本地缓存机制 ：每次查询均调用 Linear API，高频场景可能触发限流
   适用场景
   AI 代码助手自动关联 Linear 问题与 PR
   自动化周报生成（查询本周 closed issues）
   构建内部 Slack/Discord bot 集成
   CI/CD 流水线自动更新任务状态
   常规风险提示
   Token 安全 ： ~/.linear_api_token 文件权限需设置为 600，避免泄露
   数据完整性 ：批量更新操作无预览/回滚机制，建议先 --dry-run （如有）或小批量测试

   API 限流 ：Linear API 有速率限制，高频自动化需配合指数退避

   来源：独立开发者项目，GitHub 开源（czottmann/linearis），基于 MIT 或类似宽松协议