核心功能
linear-cli 是一款面向开发者的命令行工具，用于直接管理 Linear 项目管理平台。它提供了对 Linear 核心功能的完整覆盖，包括 issue 创建与更新、team 管理、project 跟踪、cycle 规划、label 分类、notification 处理等，并支持与 git 和 jj (Jujutsu) 版本控制工具的无缝集成。
显著优势
1. 工作流集成：与 git/jj 深度集成，开发者无需切换上下文即可在代码提交时同步更新 Linear 任务状态，减少上下文切换成本
2. Markdown 友好：提供 --description-file 和 --body-file 参数，支持通过文件或管道传递多行 Markdown 内容，避免 shell 转义问题，确保格式正确渲染
3. GraphQL API 直接访问：内置 api 命令可直接调用 Linear GraphQL API，并支持变量传递和 JSON 输出，满足高级自定义需求
4. 批量操作支持：通过文件和管道机制，便于脚本化和 CI/CD 集成，实现批量 issue 创建、更新和状态变更
5. 配置管理：支持 .linear.toml 配置文件，可通过 linear config 交互式生成，简化团队环境配置
潜在局限
1. 第三方实现：该项目由社区开发者 (kyaukyuai) 维护，非 Linear 官方出品，长期维护和支持存在不确定性
2. 认证依赖：需要 Linear 个人 API token，在团队共享环境或 CI/CD 中需妥善处理密钥安全
3. 功能滞后风险：Linear 官方 API 更新后，CLI 可能存在功能覆盖延迟
4. 学习曲线：相比 Web UI，CLI 需要记忆命令结构和参数，新用户上手成本较高
适用人群
- 偏好命令行工作流的开发者和技术团队
- 需要将 Linear 集成到 CI/CD 或自动化脚本中的 DevOps 工程师
- 使用 git/jj 进行版本控制且追求工作流效率的工程师
- 需要批量处理 Linear 数据或进行复杂查询的高级用户
安全风险
- API Token 暴露风险：
linear auth token可输出明文 token，在多用户环境或日志中可能造成泄露 - 权限边界：CLI 继承 token 持有者的全部 Linear 权限，误操作可能导致数据丢失或状态误变更
- 第三方代码信任：需审计开源代码或依赖预构建二进制，存在供应链安全风险
- 建议措施：使用环境变量或密钥管理服务存储 token，限制 token 权限范围，在 CI/CD 中使用只读或最小权限 token