用途:在命令行管理 Linear 议题,并支持 git 与 jj 集成,便于自动化 Linear 管理。
前提:linear 命令需在 PATH 中,可用 linear --version 检查;未安装时按 https://github.com/schpet/linear-cli?tab=readme-ov-file#install 的说明安装。
主要能力:提供 auth、issue、team、project、project-update、cycle、milestone、initiative、initiative-update、label、document、config、schema、api 等命令,覆盖认证、议题、团队、项目、周期、里程碑、倡议、标签、文档等管理,并可输出 GraphQL schema 或发起原始 GraphQL 请求。
使用方式:对含 markdown 的议题描述或评论正文,优先使用文件参数而非命令行参数,如 issue create/update 用 --description-file,comment add/update 用 --body-file,以避免换行与特殊字符的转义问题,并防止出现字面 \n。示例:linear issue create --title "My Issue" --description-file /tmp/description.md;linear issue comment add ENG-123 --body-file /tmp/comment.md。仅简单单行内容才用 --description、--body。查看子命令与参数可用 --help,如 linear issue create --help。
GraphQL API:优先使用 CLI 支持的操作,api 命令仅作为 CLI 未覆盖查询的兜底。可先 linear schema -o "${TMPDIR:-/tmp}/linear-schema.graphql" 导出 schema 再检索;含非空类型标记的查询需通过 heredoc stdin 传入,简单查询可内联,如 linear api '{ viewer { id name email } }'。需要完整 HTTP 控制时可用 linear auth token 配合 curl 调用 https://api.linear.app/graphql。
限制:资料未提供收费、价格、平台支持范围及具体效果等信息。