Linearis

核心功能

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 或类似宽松协议

核心用法

linearis 是 Linear.app 官方 CLI 的封装 Skill，专为 LLM Agent 设计，提供完整的 JSON 输出格式。核心能力包括：

Issue 管理：issues list/search/read/create/update 全生命周期操作，支持团队过滤、优先级设置（0-4）、标签管理、父工单关联
文档协作：documents list/create/read/update/delete 支持 Markdown 内容写入
评论与附件：comments create 添加工单评论，embeds upload/download 处理文件
组织信息：teams/users/projects/cycles list 查询团队结构与项目周期

认证方式：推荐 ~/.linear_api_token 文件存储，或环境变量/命令行 flag 传递

显著优点

1. LLM 原生设计：所有命令默认返回结构化 JSON，无需解析 HTML 或人类可读格式，直接喂给 Agent 处理
2. 功能覆盖完整：涵盖 Linear 核心工作流——从 Issue 创建到文档协作、评论跟进、文件附件，一站式项目管理
3. 命令语义清晰：read/update/create 等动词 + 资源类型的组合直观，学习成本低
4. 安全隔离架构：Skill 本身为纯文档配置，可执行逻辑委托给外部 npm 包，降低直接攻击面
5. 隐私合规：无用户数据收集，静态扫描未发现敏感信息硬编码

潜在缺点与局限

• 外部依赖风险：核心功能依赖 npm 包 linearis，该包由个人开发者维护（T3），更新节奏和安全响应存在不确定性
• T3 来源可信度：作者 czottmann 为独立开发者，无企业背书，需关注长期维护承诺
• 无许可证明：当前未声明开源许可证，商用场景存在潜在法律模糊地带
• 网络依赖：纯云端 API 调用，离线环境无法使用
• Token 管理：API Key 需用户自行安全存储，Skill 不提供加密保管机制

适合人群

• 使用 Linear 作为项目管理工具的敏捷团队
• 需要将 Linear 数据接入自动化工作流的开发者/DevOps
• 构建 AI Agent 需要结构化访问 Issue 追踪系统的 AI 应用开发者

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 供应链攻击 | 中 | 依赖的 npm 包被篡改或恶意更新 |

| Token 泄露 | 中 | 用户若将 API Key 写入 shell 历史或日志 |

| 数据误操作 | 低 | `update`/`delete` 命令无二次确认，Agent 可能批量误改 |

| 服务可用性 | 低 | Linear API 限速或故障时功能中断 |