拒绝低效的网页端操作，我用 OpenAPI 撸了一个 Bitbucket 命令行工具

被公司强行迁到 Bitbucket 之后，最让我痛苦的不是版本控制本身，而是那种被困在浏览器里的窒息感。习惯了在终端里快节奏操作的开发者，面对 Bitbucket 那个反应迟缓的网页端，每次查看 PR 状态或者管理分支都要经历“打开浏览器-登录-刷新-点击-等待”的循环，这种效率损失在每天几十次的操作量面前简直是折磨。

其实 Atlassian 官方一直在推 Rovo CLI，但它的定位太重，且带有明显的商业付费导向。对于我们这种只想简单管理仓库、快速同步 PR 状态的开发者来说，Rovo 就像是用大炮打蚊子，配置繁琐且不够轻量。在尝试了各种插件后，我决定走一条更直接的路：既然 Bitbucket 提供了相对完整的 OpenAPI 描述文件，为什么不直接基于这个文件构建一个轻量级的 CLI 工具？

我的核心思路是利用 OpenAPI 的定义作为基础，通过一个简单的框架将其包装成命令行接口。这种做法的优势在于，API 的覆盖率是由官方描述文件决定的，只要接口没变，功能就是稳定的。经过这段时间的实操，这个非官方的 bitbucket-cli 已经覆盖了绝大多数高频的 API 调用，让我彻底摆脱了在浏览器里不停刷新页面的窘境。

如果你也受够了网页端的低效，可以尝试按照我的方案部署一套。整个流程非常精简，不需要复杂的环境搭建。

首先，你需要确保本地已经安装了 Node.js 环境。直接通过 npm 全局安装即可快速部署：

npm install -g bitbucket-cli

安装完成后，最关键的一步是鉴权。Bitbucket 不建议直接使用主账号密码，因此你需要进入 Bitbucket 的个人设置（Personal settings） → App passwords 页面，生成一个具有相应权限的 App Password。拿到这个令牌后，在终端运行配置命令：

bitbucket-cli configure

随后按照提示依次输入你的用户名和刚刚生成的 App Password。一旦配置完成，你的本地环境就与 Bitbucket 仓库建立了安全连接。

在实际的开发流中，这个工具极大地缩短了我的反馈路径。最常用的场景就是查看 PR 列表，以前需要点开项目页面，再点入 Pull Requests 菜单，现在只需要一行命令：

bitbucket-cli pr list

不仅如此，创建分支、推送代码以及状态检查都可以在同一个终端窗口完成，无需在 IDE 和浏览器之间来回切换。

虽然这种基于 OpenAPI 自动生成的工具在细节打磨上可能不如原厂软件那么精细，但在响应速度和操作便捷度上，它完全满足了日常开发的需求。对于那些同样被困在 Atlassian 生态中、却渴望回归命令行效率的开发者来说，这是一种极低成本且高效的替代方案。如果你想尝试，可以直接在 GitHub 搜索 scr2em/bitbucket-cli 查看具体实现。