bb

bb

bb is an inoffical bitbucket.org command line tool deeply inspired by the official GitHub CLI. It brings pull requests, downloads, and other bitbucket concepts to you the terminal.

Installation

General

Check out the (Releases)[https://github.com/craftamap/bb/releases] page where you can find the latest releases built for every environment.

Arch / AUR

yay bbcli-git

Using go get

Make sure you have a working Go environment. Follow the Go install instructions.

go get github.com/craftamap/bb

Building from source

Make sure you have a working Go environment. Follow the Go install instructions.

git clone https://github.com/craftamap/bb.git
go build

Set-Up

You need to authenticate with your credentials first. You should generate a app password for that. Make sure to grant read and write access to the features you want to use. (Recommended:Repositories: Read/Write, Pull Requests: Read/Write, Pipelines: Read/Write)

Run the following command to enter your username and password:

bb auth login

Your credentials will be stored to ~/.config/bb/configuration.toml.

Usage

To see all available commands, use bb without any subcommand.

Pull Requests

You can use bb pr to list, view and merge existing pull requests and see how their pipelines run. You can also use bb pr create to create new ones.

Downloads

Manage downloads by listing, downloading or uploading them.

Development

Used Libraries

We use two multiple different bitbucket libaries:

• https://github.com/ktrysmt/go-bitbucket
• https://github.com/jsdidierlaurent/go-bitbucket

Thanks to both of these!