homebrew-bbt

This is the Homebrew tap for bbt, a command-line tool for Bitbucket Cloud.

Installation

brew tap romaintb/bbt https://codeberg.org/romaintb/homebrew-bbt.git
brew install bbt

Usage

After installation, authenticate with Bitbucket Cloud:

bbt auth login

You'll be prompted to enter:

• Bitbucket username or email
• App password or personal access token
• Default workspace (optional)

Pull Requests

# List pull requests
bbt pr list -R workspace/repo --state OPEN
# View a specific pull request
bbt pr view 123 -R workspace/repo
# Create a pull request
bbt pr create -R workspace/repo --title "Feature X" --body "Description" --head feature-branch --base main
# Merge a pull request
bbt pr merge 123 -R workspace/repo --merge-strategy merge_commit

Issues

# List issues
bbt issue list -R workspace/repo --state new
# View an issue
bbt issue view 456 -R workspace/repo
# Create an issue
bbt issue create -R workspace/repo --title "Bug title" --body "Description" --kind bug

Repositories

# List repositories
bbt repo list workspace-name
# View repository details
bbt repo view workspace/repo-slug

Updating

To update bbt to the latest version:

brew upgrade bbt

API Credentials

You need a Bitbucket App Password or Personal Access Token with appropriate scopes:

• account: For user profile access
• repository: For repository access
• pullrequest: For pull request management
• issue: For issue management

Generate one at: https://bitbucket.org/account/settings/app-passwords/

License

MIT - See bbt License