Bitbucket CLI (bkt) 命令行工具：统一管理 Data Center 和 Cloud 的自动化利器

bkt by avivsinai/bitbucket-cli

213 周安装量

54 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/avivsinai/bitbucket-cli --skill bkt

自动化开发运维命令行工具

🇨🇳中文介绍

Bitbucket CLI (bkt)

bkt 是一个适用于 Bitbucket Data Center 和 Bitbucket Cloud 的统一命令行界面。它借鉴了 gh 的交互设计，并为自动化任务提供结构化的 JSON/YAML 输出。

依赖检查

在执行任何 bkt 命令之前，请确认 CLI 已安装：

bkt --version

如果命令执行失败或未找到 bkt，请使用以下方法之一进行安装：

平台	命令
macOS/Linux	`brew install avivsinai/tap/bitbucket-cli`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

273,700 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

150,000 周安装

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

119,800 周安装

只有在确认安装成功后，才能继续执行 bkt 命令。

# Data Center (打开浏览器创建 PAT)
bkt auth login https://bitbucket.example.com --web

# Data Center (直接方式)
bkt auth login https://bitbucket.example.com --username alice --token <PAT>

# Bitbucket Cloud
bkt auth login https://bitbucket.org --kind cloud --web

# 检查认证状态
bkt auth status

Bitbucket Cloud 令牌要求：

创建一个“带作用域的 API 令牌”（而非通用 API 令牌）
选择 Bitbucket 作为应用程序
必需的作用域：Account: Read (read:user:bitbucket)
根据需要添加其他作用域：Repositories、Pull requests、Issues

上下文用于存储主机、项目/工作空间以及默认仓库设置：

# 为 Data Center 创建上下文
bkt context create dc-prod --host bitbucket.example.com --project ABC --set-active

# 为 Cloud 创建上下文
bkt context create cloud-team --host bitbucket.org --workspace myteam --set-active

# 列出和切换上下文
bkt context list
bkt context use cloud-team

任务	命令
列出仓库	`bkt repo list`
查看仓库	`bkt repo view <slug>`
克隆仓库	`bkt repo clone <slug> --ssh`
创建仓库	`bkt repo create <name> --description "..."`
列出 PR	`bkt pr list --state OPEN`
查看 PR	`bkt pr view <id>`
创建 PR	`bkt pr create --title "..." --source feature --target main`
合并 PR	`bkt pr merge <id>`
PR 检查	`bkt pr checks <id> --wait`
列出分支	`bkt branch list`
创建分支	`bkt branch create <name> --from main`
删除分支	`bkt branch delete <name>`
列出问题 (Cloud)	`bkt issue list --state open`
创建问题	`bkt issue create -t "Bug title" -k bug`
Webhooks	`bkt webhook list`
运行流水线	`bkt pipeline run --ref main`
API 应急通道	`bkt api /rest/api/1.0/projects`

bkt repo list --limit 20
bkt repo list --workspace myteam          # Cloud 工作空间覆盖
bkt repo view platform-api
bkt repo create data-pipeline --description "数据摄取" --project DATA
bkt repo browse --project DATA --repo platform-api
bkt repo clone platform-api --ssh

拉取请求工作流

# 列出和查看
bkt pr list --state OPEN --limit 10
bkt pr list --mine                        # 您创建的 PR
bkt pr view 42
bkt pr view 42 --web                      # 在浏览器中打开

# 创建和编辑
bkt pr create --title "feat: cache" --source feature/cache --target main --reviewer alice
bkt pr edit 123 --title "新标题" --body "更新后的描述"

# 评审和合并
bkt pr approve 42
bkt pr comment 42 --text "LGTM"
bkt pr merge 42 --message "merge: feature/cache"
bkt pr merge 42 --strategy fast-forward

# CI/构建状态
bkt pr checks 42                          # 显示构建状态
bkt pr checks 42 --wait                   # 等待构建完成
bkt pr checks 42 --wait --timeout 5m      # 带超时设置
bkt pr checks 42 --fail-fast              # 首次失败即退出

# 本地检出
bkt pr checkout 42                        # 检出到 pr/42 分支

bkt branch list
bkt branch list --filter "feature/*"
bkt branch create release/1.9 --from main
bkt branch delete feature/old-stuff
bkt branch set-default main               # 仅限 DC
bkt branch protect add main --type fast-forward-only  # 仅限 DC

问题跟踪 (仅限 Bitbucket Cloud)

bkt issue list --state open --kind bug
bkt issue view 42 --comments
bkt issue create -t "登录故障" -k bug -p major
bkt issue edit 42 --assignee "{uuid}" --priority critical
bkt issue close 42
bkt issue reopen 42
bkt issue comment 42 -b "已在 v1.2.0 中修复"
bkt issue status                          # 您分配/创建的问题

问题类型：bug、enhancement、proposal、task 优先级：trivial、minor、major、critical、blocker

bkt webhook list
bkt webhook create --name "CI" --url https://ci.example.com/hook --event repo:refs_changed
bkt webhook delete <id>
bkt webhook test <id>

bkt pipeline run --ref main --var ENV=staging
bkt pipeline list                         # 最近运行记录
bkt pipeline view <uuid>                  # 流水线详情
bkt pipeline logs <uuid>                  # 获取日志
bkt status pipeline <uuid>                # 替代方案：状态检查

bkt perms project list --project DATA
bkt perms project grant --project DATA --user alice --perm PROJECT_WRITE
bkt perms repo list --project DATA --repo platform-api
bkt perms repo grant --project DATA --repo api --user alice --perm REPO_WRITE

对于尚未封装的端点：

bkt api /rest/api/1.0/projects --param limit=100 --json
bkt api /repositories --param workspace=myteam --field pagelen=50

所有命令都支持结构化输出：

bkt pr list --json                        # JSON 输出
bkt pr list --yaml                        # YAML 输出
bkt pr list --json | jq '.pull_requests[0].title'

--json / --yaml — 结构化输出
--context <name> — 使用特定上下文
--project <key> — 覆盖项目 (DC)
--workspace <name> — 覆盖工作空间 (Cloud)
--repo <slug> — 覆盖仓库

BKT_CONFIG_DIR — 配置目录覆盖
BKT_ALLOW_INSECURE_STORE — 允许基于文件的凭据存储
BKT_KEYRING_TIMEOUT — 密钥环操作超时（例如 2m）

完整命令参考 : 参见 references/commands.md

🇺🇸English

Bitbucket CLI (bkt)

bkt is a unified CLI for Bitbucket Data Center and Bitbucket Cloud. It mirrors gh ergonomics and provides structured JSON/YAML output for automation.

Dependency Check

Before executing anybkt command, verify the CLI is installed:

bkt --version

If the command fails or bkt is not found, install it using one of these methods:

Platform	Command
macOS/Linux	`brew install avivsinai/tap/bitbucket-cli`
Windows	`scoop bucket add avivsinai https://github.com/avivsinai/scoop-bucket && scoop install bitbucket-cli`
Go	`go install github.com/avivsinai/bitbucket-cli/cmd/bkt@latest`
Binary	Download from GitHub Releases

Only proceed withbkt commands after confirming installation succeeds.

Authentication

# Data Center (opens browser for PAT creation)
bkt auth login https://bitbucket.example.com --web

# Data Center (direct)
bkt auth login https://bitbucket.example.com --username alice --token <PAT>

# Bitbucket Cloud
bkt auth login https://bitbucket.org --kind cloud --web

# Check auth status
bkt auth status

Bitbucket Cloud Token Requirements:

Create an "API token with scopes" (not a general API token)
Select Bitbucket as the application
Required scope: Account: Read (read:user:bitbucket)
Additional scopes as needed: Repositories, Pull requests, Issues

Contexts

Contexts store host, project/workspace, and default repo settings:

# Create context for Data Center
bkt context create dc-prod --host bitbucket.example.com --project ABC --set-active

# Create context for Cloud
bkt context create cloud-team --host bitbucket.org --workspace myteam --set-active

# List and switch contexts
bkt context list
bkt context use cloud-team

Quick Command Reference

Task	Command
List repos	`bkt repo list`
View repo	`bkt repo view <slug>`
Clone repo	`bkt repo clone <slug> --ssh`
Create repo	`bkt repo create <name> --description "..."`
List PRs	`bkt pr list --state OPEN`
View PR	`bkt pr view <id>`

Repository Operations

bkt repo list --limit 20
bkt repo list --workspace myteam          # Cloud workspace override
bkt repo view platform-api
bkt repo create data-pipeline --description "Data ingestion" --project DATA
bkt repo browse --project DATA --repo platform-api
bkt repo clone platform-api --ssh

Pull Request Workflows

# List and view
bkt pr list --state OPEN --limit 10
bkt pr list --mine                        # PRs you authored
bkt pr view 42
bkt pr view 42 --web                      # Open in browser

# Create and edit
bkt pr create --title "feat: cache" --source feature/cache --target main --reviewer alice
bkt pr edit 123 --title "New title" --body "Updated description"

# Review and merge
bkt pr approve 42
bkt pr comment 42 --text "LGTM"
bkt pr merge 42 --message "merge: feature/cache"
bkt pr merge 42 --strategy fast-forward

# CI/build status
bkt pr checks 42                          # Show build status
bkt pr checks 42 --wait                   # Wait for builds to complete
bkt pr checks 42 --wait --timeout 5m      # With timeout
bkt pr checks 42 --fail-fast              # Exit on first failure

# Checkout locally
bkt pr checkout 42                        # Fetches to pr/42 branch

Branch Management

bkt branch list
bkt branch list --filter "feature/*"
bkt branch create release/1.9 --from main
bkt branch delete feature/old-stuff
bkt branch set-default main               # DC only
bkt branch protect add main --type fast-forward-only  # DC only

Issue Tracking (Bitbucket Cloud Only)

bkt issue list --state open --kind bug
bkt issue view 42 --comments
bkt issue create -t "Login broken" -k bug -p major
bkt issue edit 42 --assignee "{uuid}" --priority critical
bkt issue close 42
bkt issue reopen 42
bkt issue comment 42 -b "Fixed in v1.2.0"
bkt issue status                          # Your assigned/created issues

Issue kinds: bug, enhancement, proposal, task Priorities: trivial, minor, major, critical, blocker

Webhooks

bkt webhook list
bkt webhook create --name "CI" --url https://ci.example.com/hook --event repo:refs_changed
bkt webhook delete <id>
bkt webhook test <id>

Pipelines (Cloud)

bkt pipeline run --ref main --var ENV=staging
bkt pipeline list                         # Recent runs
bkt pipeline view <uuid>                  # Pipeline details
bkt pipeline logs <uuid>                  # Fetch logs
bkt status pipeline <uuid>                # Alt: status check

Permissions (DC)

bkt perms project list --project DATA
bkt perms project grant --project DATA --user alice --perm PROJECT_WRITE
bkt perms repo list --project DATA --repo platform-api
bkt perms repo grant --project DATA --repo api --user alice --perm REPO_WRITE

Raw API Access

For endpoints not yet wrapped:

bkt api /rest/api/1.0/projects --param limit=100 --json
bkt api /repositories --param workspace=myteam --field pagelen=50

Output Modes

All commands support structured output:

bkt pr list --json                        # JSON output
bkt pr list --yaml                        # YAML output
bkt pr list --json | jq '.pull_requests[0].title'

Global Options

--json / --yaml — Structured output
--context <name> — Use specific context
--project <key> — Override project (DC)
--workspace <name> — Override workspace (Cloud)
--repo <slug> — Override repository

Environment Variables

BKT_CONFIG_DIR — Config directory override
BKT_ALLOW_INSECURE_STORE — Allow file-based credential storage
BKT_KEYRING_TIMEOUT — Keyring operation timeout (for example 2m)

References

Full command reference : See references/commands.md

Weekly Installs

113

Repository

avivsinai/bitbucket-cli

GitHub Stars

First Seen

Jan 26, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykWarn

Installed on

gemini-cli93

codex91

cursor88

opencode87

claude-code86

github-copilot83

Bitbucket CLI (bkt) 命令行工具：统一管理 Data Center 和 Cloud 的自动化利器

🇨🇳中文介绍

Bitbucket CLI (bkt)

依赖检查

相关 Skills

身份验证

上下文

快速命令参考

仓库操作

拉取请求工作流

分支管理

问题跟踪 (仅限 Bitbucket Cloud)

Webhooks

流水线 (Cloud)

权限 (DC)

原始 API 访问

输出模式

全局选项

环境变量

参考

🇺🇸English

Bitbucket CLI (bkt)

Dependency Check

Authentication

Contexts

Quick Command Reference

Repository Operations

Pull Request Workflows

Branch Management

Issue Tracking (Bitbucket Cloud Only)

Webhooks

Pipelines (Cloud)

Permissions (DC)

Raw API Access

Output Modes

Global Options

Environment Variables

References

最新 Skills