linear-cli

在终端中高效管理 Linear 项目和任务的 CLI 工具。

安装使用

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

帮我安装这个 AI Skill:linear-cli。
它的用途是:在终端中高效管理 Linear 项目和任务的 CLI 工具。
完整的 Skill 内容见:https://321skill.com/skills/linear-cli/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“帮我列出 ENG 团队当前周期所有未完成的任务。”,它会调用 `linear issue list --team ENG --cycle current` 命令并返回结果。或者

对AI说:“创建一个新的高优先级任务,并关联到现有任务。”,它可以指导你使用 `linear issue create --team ENG --title '修复登录Bug' --priority 0 --blocked-by ENG-101` 这样的命令来快速创建。

介绍

linear-cli 是一个专为 Linear 项目管理平台打造的快速、高效的命令行工具。它解决了开发者需要频繁在浏览器和终端之间切换来管理任务的问题,让你无需离开熟悉的命令行环境,就能完成创建、查看、更新、关闭 Issue,以及管理 Cycles 和 Teams 等核心操作。

使用上,它通过个人 API 密钥进行身份验证,支持多种安装方式(如 Homebrew、Go install),并提供了丰富的命令和全局标志(如 JSON 输出、静默模式)来满足不同场景的需求。其设计注重与脚本的友好集成,方便自动化工作流。

这个工具非常适合那些深度使用 Linear 进行项目管理,并且大部分工作时间都在终端中度过的开发者和技术团队负责人。它能显著提升任务管理的流畅度和效率。

建议首次使用时,通过 linear auth login 或设置 LINEAR_API_KEY 环境变量来配置认证。对于脚本调用,推荐使用 --json 标志来获取结构化数据,并注意 Issue 引用参数可能接受 ID 或标识符(如 ENG-123),若遇到“未找到”错误,请使用 --json 输出中的规范 ID。

核心特点

这是一个用 Go 编写的原生 CLI 工具,执行速度快,且专门为与脚本集成而设计,提供了 `--json` 输出和管道支持,便于自动化。相比一些基于 Node.js 或 Python 的同类工具,它在启动速度和资源消耗上更有优势。

注意事项

主要面向使用 Linear 平台的团队和个人,对于不使用 Linear 或需要复杂 GUI 操作的项目管理场景不适用。

常见问题

如何设置 API 密钥?

推荐在 shell 配置文件中设置 LINEAR_API_KEY 环境变量,或运行 `linear auth login` 命令本地存储。

如何用脚本处理命令输出?

使用 `--json` 全局标志,命令会输出 JSON 格式数据,方便用 `jq` 等工具解析。

给 AI 助手的安装指引

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

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