用途:linear-api 是 linear-cli 提供的能力,用于直接对 Linear API 执行原始 GraphQL 查询(query)与变更(mutation),适合处理其他命令未覆盖的高级操作。
主要能力:可运行 GraphQL 查询与变更;通过 -v key=val 传入 GraphQL 变量;支持从文件管道读入查询内容;可选 JSON 输出与紧凑 JSON 输出;提供明确的退出码。
使用方式:运行查询示例为 linear-cli api query '{ viewer { id name email } }';带变量查询为 linear-cli api query -v teamId=abc '{ team(id: $teamId) { name } }';执行变更为 linear-cli api mutate -v title="Bug" 后接 mutation 语句;也可用 cat query.graphql | linear-cli api query - 从文件管道输入。标志:-v key=val 传入变量,--output json 输出 JSON,--compact 输出紧凑 JSON。退出码:0 成功,1 错误,2 未找到,3 认证错误。
适用场景:需要调用 Linear GraphQL API 完成自定义查询、写入或使用未封装命令的高级操作。
限制:具体变更字段、权限范围、速率限制等资料暂未提供;使用前需具备 Linear 认证,认证失败会返回退出码 3。