用途:lin 是安装在 $PATH 上的命令行工具,用于以脚本或智能体方式操作 Linear,覆盖 issue、项目、文档、计划、周期、客户请求、团队、用户、标签等对象。
主要能力:issue 的搜索、列表、查看、新建、更新字段(状态、负责人、优先级、项目、估点、截止日期、周期、父级)、评论(含线程回复与文件附件)、历史、归档/删除、关联关系与附件(GitHub PR、GitLab MR、Slack 等);项目管理(含健康状态更新帖);计划、文档、团队、用户、标签、周期查询;文件上传下载;客户请求与客户查询;可用 lin api query 执行原始 GraphQL。
使用方式:先设置 LINEAR_API_KEY 环境变量,或用 lin auth login <api-key> --alias myorg 存储并管理多工作区。常用命令如 lin issue get ENG-123、lin issue new、lin issue update status、lin project get、lin document get 等。列表与搜索默认输出 JSONL,get 默认 NDJSON,可用 --format json|yaml|jsonl|pretty 覆盖。长文本默认截断约 200 字符,用 --expand 或 --full 展开。支持分页 --limit 与 --cursor,默认值可用 lin config set 持久化。每个顶层命令提供 lin <command> usage 详细文档。
限制与注意:绝不直接读取或使用 Linear API key,不要 curl Linear API,也不要从环境变量提取凭据,认证由 lin 内部处理。结构化命令优先于 lin api query。MCP 场景下客户端无文件系统,下载文件返回可获取的引用,需通过内置 fs 工具读取。部分命令行为与输出细节以官方 usage 文档为准。