📦 Linear Native Node

使用脚本/linear.mjs直接与Linear的GraphQL API（https://api.linear.app/graphql）交互。Native Node 18+，零npm依赖。支持Windows、macOS和Linux。无需bash、Python、OAuth网关、浏览器登录或第三方代理。

为什么选择这个技能 这是常见的Linear辅助工作流的私人/直接版本： 保持API访问仅在此机器和Linear之间。 使用来自进程环境的LINEAR_API_KEY；永远不会打印该密钥。 避免使用bash导向的辅助工具，它们在Windows上会崩溃。 避免使用第三方OAuth/网关工具；没有Maton风格的中间人。 * 保持紧密的可审计范围：查看器/组织/团队查找、问题列表/读取/创建/更新/评论、实用个人摘要和分支名称。

设置 在https://linear.app/settings/api创建一个Linear API密钥： PowerShell会话设置： $env:LINEAR_API_KEY = "" $env:LINEAR_DEFAULT_TEAM = "TEAM" macOS/Linux shell会话设置： export LINEAR_API_KEY="" export LINEAR_DEFAULT_TEAM="TEAM" LINEAR_DEFAULT_TEAM是可选的。以下示例使用TEAM和TEAM-123作为占位符；请将其替换为您的Linear团队密钥和问题标识符。

运行 从PowerShell、bash、zsh或任何具有Node PATH的shell运行： node "/scripts/linear.mjs" help node "/scripts/linear.mjs" viewer node "/scripts/linear.mjs" issues --team TEAM --mine --limit 10 从OpenClaw运行，使用捆绑的脚本： 运行：node /scripts/linear.mjs my-issues --team TEAM 运行：node /scripts/linear.mjs create TEAM "Fix login error" "Users see an error after submitting credentials." --priority high 在命令中添加--json以获得结构化输出。

命令 只读： help viewer organization teams projects [--team TEAM] [--limit N] states issues [--team TEAM] [--mine] [--state STATE] [--limit N] my-issues [--team TEAM] [--state STATE] [--limit N] my-todos [--team TEAM] [--limit N] urgent [--team TEAM] [--mine] [--limit N] standup [--team TEAM] [--limit N] issue branch 写入Linear： project-create [TEAM_KEY] "Name" ["Description"] create [TEAM_KEY] "Title" ["Description"] [--priority urgent|high|medium|low|none] comment "Comment" status priority 对于代理使用，请仅在用户明确请求Linear更改或显式批准时执行写入命令。

示例 列出团队、项目和状态： node "/scripts/linear.mjs" teams node "/scripts/linear.mjs" projects --team TEAM --limit 20 node "/scripts/linear.mjs" states TEAM 创建一个项目： node "/scripts/linear.mjs" project-create TEAM "Release Planning" "Track launch scope and milestones." 列出问题： node "/scripts/linear.mjs" issues --team TEAM --limit 20 node "/scripts/linear.mjs" issues --team TEAM --mine --state "In Progress" node "/scripts/linear.mjs" my-issues --team TEAM node "/scripts/linear.mjs" my-todos --team TEAM node "/scripts/linear.mjs" urgent --team TEAM 读取和更新问题： node "/scripts/linear.mjs" issue TEAM-123 node "/scripts/linear.mjs" comment TEAM-123 "Added reproduction notes." node "/scripts/linear.mjs" status TEAM-123 "In Progress" node "/scripts/linear.mjs" priority TEAM-123 urgent 创建问题： node "/scripts/linear.mjs" create TEAM "Fix notification delivery" "Notifications are delayed for some users." --priority high 从Linear问题标题生成GitHub友好的分支名称： node "/scripts/linear.mjs" branch TEAM-123 获取机器可读输出： node "/scripts/linear.mjs" my-issues --team TEAM --json

注意 更喜欢使用TEAM-123这样的问题标识符；脚本在需要Linear ID的更新之前解析它们。 优先级值映射到Linear的本机值：urgent、high、medium、low、none。 缺失密钥、401/403响应、GraphQL错误、缺失团队/状态和无效优先级会产生清晰的stderr错误和非零退出代码。 standup总结了已分配的活动和最近完成的问题；它故意轻量级，不是时间跟踪器。