【免费下载链接】linear-clilinear without leaving the command line: list, start, and create PRs for linear issues. agent friendly.项目地址https://gitcode.com/gh_mirrors/lin/linear-cli点击查看免费下载如果你正在用 Claude Code 等 AI Agent 写代码那一定体会过代码改完了Issue 却还要手动回浏览器创建、指派、改状态。linear-cli 是一个面向 Linear 的命令行工具而它内置的 Skill 正是 AI Agent 的新利器——把 Claude Code 接入终端后Agent 可以自动创建 Issue、更新状态、添加评论全程不用切换窗口真正实现代码和项目管理同频。一、linear-cli 是什么为什么 AI Agent 需要它linear-cli 的定位一句话概括Linear without leaving the command line——在终端里完成 List、Start、Create、更新 Issue 等全套操作并且天然 Agent friendly。它和 AI Agent 特别契合的三点原因命令结构化每个操作都是独立的子命令issue create、issue update……Agent 能精确调用不用拼 HTTP 请求JSON 输出几乎所有命令都支持--jsonAgent 可以直接读取结构化结果明确的退出码命令失败时退出码能告诉脚本为什么失败认证问题、找不到资源、网络超时等Agent 无需解析报错文本就能判断该不该重试二、快速安装linear-cli 与 Claude Code Skill1️⃣ 安装 CLI 本体按你的习惯任选一种方式详见 README.md# Homebrew brew install schpet/tap/linear # 或 npm / bun / pnpm npm install -D schpet/linear-cli装完先验证一下linear --version2️⃣ 为 Claude Code 安装 SkillSkill 的完整说明位于仓库的 SKILL.md 文件中它相当于 Agent 的操作手册。通过 Claude Code 的插件系统安装# 在 Claude Code 内 /plugin marketplace add schpet/linear-cli /plugin install linear-clilinear-cli也支持从 bash 执行claude plugin install linear-clilinear-cli升级时运行claude plugin update linear-clilinear-cli即可。其他 Agent 用户可以通过 skills.sh 的npx skills add方式安装。三、三步完成配置认证、登录、仓库关联Skill 再智能也要先让 CLI 能连上你的 Linear 工作区创建 API Key在 Linear 的 Account Settings → Security 页面生成一个 API key登录 CLIlinear auth login关联项目仓库在你要管理 Issue 的 git 仓库根目录执行linear config该命令会询问默认 Team 和排序方式并在仓库根目录写入.linear.toml配置文件配置解析规则详见 docs/usage.md。配置完成后CLI 还能通过分支名如eng-123-my-feature自动识别当前正在做哪个 Issue。四、实战场景一让 Claude Code 自动创建 Issue这是 Skill 最高频的用法。你只需对 Claude Code 说一句帮我提一个 Bug Issue标题是登录页 Safari 下白屏Agent 就会执行类似这样的命令linear issue create --team ENG --title Fix login redirect \ --description-file ./description.md --no-input关键参数解读参数作用--team ENG指定 Team可用 key、名称或 ID--description-file描述写入 Markdown 文件再传入多行内容格式不乱--no-input脚本模式下永不交互式提问缺参数直接报错如果你的团队有规范的 Issue 模板比如 Bug reportAgent 也可以直接套用linear template list --type issue --team ENG # 先列出可用模板 linear issue create --team ENG --template Bug report --title Login fails on Safari模板会预填标题字段、标签、正文等--title、--label等显式传参可以覆盖模板值细节见 skills/linear-cli/references/issue.md。创建后还能顺手拿链接、加评论linear issue url ENG-123 # 打印 Issue 的 Web 链接 linear issue comment add ENG-123 --body-file ./comment.md五、实战场景二一句话更新 Issue 状态开发过程中状态流转是重头戏issue update只更新你传入的字段其余保持不变linear issue update ENG-123 --state In Review --assignee sam linear issue update ENG-123 --state Done # 完成后关闭常用能力还有--add-label/--remove-label增量改标签、--unassign取消指派、--start配合issue start自动建分支并标记开始。典型工作流对 Claude Code 说代码写完了把当前 Issue 移到 In Review 并 一下同事Agent 依次执行issue update和issue comment add而当前 Issue是它从分支名里自动解析出来的——全程零手工操作。六、让 Agent 稳定发挥的 3 个技巧技巧 1优先用文件参数传 Markdown 内容多行描述、评论一律写进文件再用--description-file/--body-file传入避免 shell 转义问题Linear Web 端渲染也最干净这是 SKILL.md 中明确要求 Agent 遵守的最佳实践。技巧 2用--json喂给 Agent 读linear issue query --search login bug --jsonissue query可以按 team、state、label、assignee 等任意组合过滤是 Agent 检索 Issue 的主力命令而issue list默认只显示分配给我的两者别混用。技巧 3靠退出码判断失败原因命令失败时 Agent 不必逐字解析 stderr退出码就是答案完整表格见 README.md退出码含义Agent 该怎么处理3Issue / Team 不存在换个 ID 或先issue query查一下4认证失败提示用户重新linear auth login重试无意义5网络 / 限流 / 服务器错误稍后重试但创建操作可能已生效七、Skill 是怎么教 Agent 用 CLI 的Skill 本质上是一份带工具白名单的 Markdown 指令文件头部声明Bash(linear:*)允许 Agent 直接调用 linear 命令。它告诉 Agent 三件事常用任务的配方查询、创建、更新、评论、模板等流程各给了可复制的命令样例参考文档目录skills/linear-cli/references/ 下按模块拆分的参考文档issue、auth、config、project、team 等Agent 需要时按需查阅兜底方案CLI 没覆盖的操作可以走linear api直接发 GraphQL 请求甚至用linear auth token配合 curl 拿完整控制权这意味着 Agent 不只是会敲几个命令而是真正理解 Linear 工作流的语义——比如它知道应该关闭而不是手动归档 Issue、知道 Linear 的 mention 必须用纯 URL 而不是名字。八、常见问题速查Guest 账号能登录吗创建 API Key 需要 member 权限guest 账号不可用能同时管多个工作区吗可以用linear auth list/linear auth default管理命令上加--workspace slug切换多工作区细节见 docs/authentication.mdAgent 会误删 Issue 吗所有删除、归档、移除类命令默认都会先确认Skill 也明确指导 Agent 谨慎使用issue archivejj 用户支持吗支持CLI 同时适配 git 与 jj通过提交描述中的Linear-issuetrailer 识别当前 Issue小结linear-cli 的 Skill 把CLI 工具升级成了AI Agent 的 Linear 能力包装好 CLI、登录一次、装上 Skill之后无论是让 Claude Code 自动创建 Bug Issue、还是把 Issue 从 Started 推到 Done都只需一句话。如果你的团队在用 Linear AI 编程这套组合值得今天就试起来。赞分享【免费下载链接】linear-clilinear without leaving the command line: list, start, and create PRs for linear issues. agent friendly.项目地址https://gitcode.com/gh_mirrors/lin/linear-cli点击查看免费下载相关推荐qiankun Agent Skill 实战指南让 Claude Code、Cursor 自动创建主应用与微应用qiankun Agent Skill 实战指南让 Claude Code、Cursor 自动创建主应用与微应用 qiankun 以 Agent Skills前端微前端linear-cli issue pr 实战基于当前分支的 Linear Issue 自动创建 GitHub PRlinear cli issue pr 实战基于当前分支的 Linear Issue 自动创建 GitHub PR linear cli 是一个让开发者不离claude-howto 实战用 claude-md Skill 创建、更新与审计 CLAUDE.md为 AI Agent 打造高效的 Onboarding 文档claude howto 实战用 claude md Skill 创建、更新与审计 CLAUDE.md为 AI Agent 打造高效的 Onboarding文档教程知识库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考