linear-cli

一个用于在命令行管理 Linear 工单的 CLI 工具,支持 Git/JJ 集成。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:linear-cli。
它的用途是:一个用于在命令行管理 Linear 工单的 CLI 工具,支持 Git/JJ 集成。
完整的 Skill 内容见:https://321skill.com/skills/linear-cli-schpet/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我为登录页面的样式问题创建一个 Linear 工单。”,它会调用 linear-cli 技能,引导你输入标题、描述、优先级等信息,并直接在命令行创建工单。或者,在编码时

对AI说:“查看当前分支关联的工单详情。”,它会运行 `linear issue view` 命令,将工单的详细信息以 Markdown 格式输出在终端。

介绍

linear-cli 是一个专为 Linear 项目管理平台设计的命令行工具,旨在让开发者无需离开终端即可高效处理工单。它解决了在开发流程中频繁切换浏览器或桌面应用查看、创建、更新工单的痛点,将工单管理无缝集成到命令行工作流中。

使用上,首先通过 linear auth login 配置 API 密钥,然后在项目目录运行 linear config 完成初始化。之后,你可以使用 linear issue mine 查看分配给你的工单,用 linear issue start 基于工单创建开发分支,用 linear issue create 快速创建新工单,甚至用 linear issue pr 一键生成预设好的 PR。

该工具特别适合深度使用 Linear 进行项目管理的开发团队,尤其是前端开发、后端开发、全栈开发等需要频繁处理开发任务和工单流转的角色。它能让开发者在编码上下文中直接操作相关工单,减少上下文切换。

建议将其与你的版本控制系统(Git 或 JJ)深度结合。对于 Git,确保分支名包含 Linear 工单 ID;对于 JJ,则利用 commit 描述中的 Linear-issue 标记。这样可以实现工单状态与代码变更的自动关联。

核心特点

与同类 CLI 工具相比,linear-cli 深度集成了 Git 和 JJ 版本控制系统,能根据当前分支或提交自动识别并关联 Linear 工单,实现了代码上下文与项目管理上下文的智能绑定。此外,它原生提供了供 AI Agent 调用的技能接口,允许智能体直接创建、更新工单,这在自动化工作流中是一个独特优势。

注意事项

该工具主要面向使用 Linear 作为项目管理工具的开发团队,对于使用 Jira、Asana 等其他系统的用户不适用。

常见问题

如何配置 linear-cli?

先在 Linear 官网生成 API 密钥,然后在终端运行 `linear auth login` 登录,最后在项目目录运行 `linear config` 完成项目配置。

它支持哪些版本控制系统?

主要支持 Git 和 JJ。对于 Git,通过分支名识别工单;对于 JJ,通过 commit 描述中的 `Linear-issue` 标记识别。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/linear-cli-schpet/raw/index.md 读取 linear-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。