核心用法
linear-cli 是一款专为AI代理（如Claude Code、Codex）设计的Linear命令行工具，提供完整的项目管理自动化能力。核心工作流遵循"发现→读取→预览→执行"模式：先通过 linear capabilities --json 探测命令特性，读取状态使用 --json 获取结构化输出，写操作前用 --dry-run --json 预览变更，最后执行并解析退出码与 error.details。
工具覆盖Linear全资源类型：issues、projects、cycles、documents、notifications、webhooks等。支持文件或stdin传入markdown内容，避免shell转义问题。直接GraphQL API访问作为CLI未覆盖场景的fallback。
显著优点
- Agent优先设计：稳定的JSON契约、机器可解析的错误详情，专为自动化场景优化
- 安全预览机制：
--dry-run支持在真实执行前验证变更 - Git/JJ工作流集成：适合CI/CD流水线中的项目管理自动化
- 灵活内容输入：文件引用与stdin管道兼顾，markdown格式正确处理
- 完备的资源覆盖：从issue到initiative、从label到milestone的全栈管理能力
潜在局限
- 需预装CLI工具并配置PATH，首次使用有部署成本
- 复杂GraphQL查询需手动处理变量转义和heredoc语法
- 作为第三方开源工具，功能更新依赖社区维护
- 直接API调用绕过CLI抽象层时，失去dry-run等安全特性
适合人群
- 使用Claude Code/Codex等AI编程助手的开发者
- 需要在CI/CD中自动化Linear工作流的DevOps工程师
- 偏好命令行和脚本化管理的效率型团队
- 需要批量操作或自定义集成的技术团队
常规风险
- 认证泄露风险：
linear auth token暴露的API密钥需妥善保管，避免日志泄露 - 写操作误触：虽有dry-run，但自动化脚本中的逻辑错误仍可能导致批量误操作
- GraphQL注入：直接构造API调用时需注意变量转义，防范注入攻击
- 依赖维护：开源项目存在维护中断或API兼容性变更风险