bitbucket-cli
🥈SilverBitbucket CLI with gh-like ergonomics for developers, coding agents, and automation-first teams. Streamline Bitbucket Cloud & Data Center workflows, manage pull requests, and automate CI/CD processes. Integrates with Claude for enhanced automation.
8330Updated 2mo ago
Intermediate30min to implementautomation
Saves ~30 min per use
Quick InstallView Source
git clone https://github.com/avivsinai/bitbucket-cli.gitWorks with:
Claude
Overview
About This Skill
bkt is a command-line interface for Bitbucket Data Center and Bitbucket Cloud that mirrors the ergonomics of gh. Built for AI agents and automation, it delivers structured JSON/YAML output, predictable flags, and safe defaults that integrate directly into Claude Code, Cursor, and shell scripts without glue code. The CLI enables developers and automation teams to streamline pull request management, repository workflows, and CI/CD processes through a consistent interface across both Bitbucket platforms. It supports multiple authentication methods including OAuth, API tokens, and personal access tokens, and works seamlessly in headless environments like Bitbucket Pipelines and containers through environment variables.
How to Use
Install via Homebrew (macOS/Linux), Scoop (Windows), or Go. Run `bkt auth login` to authenticate, then use commands like `bkt pr list` and `bkt pr create`. For headless use in pipelines, set environment variables `BKT_TOKEN`, `BKT_HOST`, and repository identifiers.
Use Cases
Automate pull request creation and management in CI/CD pipelines
Give Claude Code native Bitbucket CLI commands for code reviews and deployments
Streamline repository operations across Bitbucket Cloud and Data Center
Enable headless Bitbucket workflows in containers and shell scripts
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/avivsinai/bitbucket-cliRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Act as a Bitbucket CLI tool with gh-like ergonomics. I'm a developer at [COMPANY] working in the [INDUSTRY] sector. I need to [TASK] using Bitbucket Cloud/Data Center. Provide the exact CLI commands I should run, along with explanations for each step. Ensure the commands are compatible with Bitbucket's API and can be integrated with Claude for automation.
Example Output
# Bitbucket CLI Commands for Pull Request Management ## Fetching Open Pull Requests ```bash bb pr list --state open --workspace [COMPANY] --repo [REPOSITORY] ``` This command will list all open pull requests in the specified repository. The `--state open` flag filters for open PRs, and `--workspace` and `--repo` specify the target repository. ## Creating a New Pull Request ```bash bb pr create --source [SOURCE_BRANCH] --dest [DESTINATION_BRANCH] --title "[TITLE]" --description "[DESCRIPTION]" --workspace [COMPANY] --repo [REPOSITORY] ``` This command creates a new pull request. Replace `[SOURCE_BRANCH]` and `[DESTINATION_BRANCH]` with the appropriate branch names, and provide a title and description for the PR. ## Merging a Pull Request ```bash bb pr merge --id [PR_ID] --workspace [COMPANY] --repo [REPOSITORY] ``` This command merges the specified pull request. Replace `[PR_ID]` with the ID of the PR you want to merge.
Apply to these tools
Browse all toolsBitbucket
Collaborate on code with Git management, pull requests, and automated CI/CD workflows.
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
Drata
Automate security compliance and monitor real-time security posture seamlessly.
GPT for work
Automate your spreadsheet tasks with AI power
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan