Linear CLI：AI Agent优先的项目管理工具
Linear CLI 是一款专为 Claude Code、Codex 等 AI Agent 设计的命令行工具，用于与 Linear 项目管理平台进行稳定、可靠的交互。该工具采用 "Agent-First" 设计理念，核心优势在于提供稳定的 JSON 契约输出和dry-run 预览机制，使自动化工作流具备可预测性和安全性。
核心用法
CLI 覆盖 Linear 全功能栈，包括 issue、project、cycle、document、notification、webhook 等资源的管理。推荐的使用流程为：先通过 linear capabilities --json 发现命令特性，使用 --json 读取状态，通过 --dry-run --json 预览变更，最后应用写入。对于 Markdown 内容，建议使用 --description-file 或 --body-file 标志，避免 shell 转义问题。
显著优点
1. 稳定的机器可读输出：所有命令支持 --json 标志，返回结构化数据而非样式化终端文本，便于 Agent 解析
2. 安全的写操作预览：--dry-run 模式允许在实际变更前验证操作，配合详细的退出码和 error.details 机制
3. 超时感知的写入语义：内置超时控制，防止长时间挂起
4. Git/JJ 工作流集成：与版本控制工作流深度整合
5. GraphQL 兜底能力：通过 linear api 命令可直接访问底层 GraphQL API
潜在局限
- 需要预先安装
linear命令到 PATH，存在部署依赖 - 复杂 GraphQL 查询需使用 heredoc 避免转义问题，对新手有一定学习成本
- 作为第三方 CLI 工具，功能更新可能滞后于 Linear 官方 API 变化
适合人群
- 使用 Claude Code、Codex 等 AI 编程助手的开发者
- 需要自动化 Linear 工作流的 DevOps 工程师
- 寻求可脚本化、可集成项目管理方案的技术团队
- 重视操作可审计性和可重复性的企业用户
常规风险
该工具需要 Linear API 访问令牌，涉及敏感凭证管理。建议遵循最小权限原则，定期轮换 token，并在 CI/CD 环境中使用密钥管理服务。--dry-run 模式虽能降低误操作风险，但仍建议在生产环境变更前进行充分测试。
来源可信度：开源项目 (GitHub: kyaukyuai/linear-cli)，有详细文档支持，但非 Linear 官方出品。