bkt

Bitbucket CLI（bkt）

使用 bkt 执行 Bitbucket Cloud 和 Data Center 操作。自动化时优先使用结构化 的 --json、--yaml、--jq 或 --template 输出。

从所请求的操作开始

只有在安装情况或兼容性不确定时才运行 bkt --version。当命令需要身份验证，或 无法确定当前平台和上下文时，运行 bkt auth status。如果只读请求所需的配置已经 完成，不要将设置作为前置条件。

Cloud 和 Data Center 的功能集不同。根据当前上下文确定平台；无法推断时再询问。 不要为 Data Center 建议仅适用于 Cloud 的命令，反之亦然。

安装、身份验证、创建上下文或了解主要命令模式时，请阅读设置和常见工作流。 对于无需配置的 CI 或容器，请阅读无头身份验证。

跳转到命令参考

只阅读所请求命令组对应的参考文档：

• 拉取请求、仓库、 分支、提交或 状态
• 流水线或变量
• Bitbucket Cloud Issues 已不复存在（Atlassian 于 2026 年 8 月将其移除）；请将问题跟踪转至 Jira。
• Data Center 管理、 项目或权限
• 身份验证、上下文、 Webhook、扩展、 MCP、技能或原始 API

修改操作和凭据边界

• 列出、查看、状态和检查操作均为只读。创建、编辑、批准、 合并、删除、重新运行或更改权限会修改 Bitbucket；只有用户要求进行相应更改时才执行。
• 不要将令牌、OAuth 密钥或密码放入可能写入日志或提交到文件中的命令。请使用 CLI 支持的 凭据流程，或身份验证参考文档中说明的环境变量。
• 每个 bkt 版本都包含其 Cloud 浏览器 OAuth 消费者，因此 bkt auth login --kind cloud --web 无需设置。
• 执行合并或其他影响重大的写入操作前，请检查确切的目标、仓库和当前检查结果。 报告操作后生成的 URL 或标识符。

参考文档

• admin — Bitbucket 管理操作 (DC)
• auth — 管理 Bitbucket 身份验证凭据
• branch — 检查和管理分支
• commit — 处理提交
• context — 管理 Bitbucket CLI 上下文
• extension — 管理 bkt CLI 扩展
• mcp — 面向 Agent 的 Model Context Protocol 服务
• perms — 管理 Bitbucket 权限 (DC)
• pipeline — 运行和检查 Bitbucket Cloud 流水线 (Cloud)
• pr — 管理拉取请求
• project — 处理 Bitbucket 项目 (DC)
• repo — 处理 Bitbucket 仓库
• skill — 安装和管理 Agent 技能
• status — 检查提交和拉取请求的状态
• variable — 管理流水线变量 (Cloud)
• webhook — 管理 Bitbucket Webhook
• other — api