https://github.com/bb-cli/bb-cli
Bitbucket Rest API CLI written in pure PHP
https://github.com/bb-cli/bb-cli
bitbucket bitbucket-api bitbucket-cli cli php-cli
Last synced: about 2 months ago
JSON representation
Bitbucket Rest API CLI written in pure PHP
- Host: GitHub
- URL: https://github.com/bb-cli/bb-cli
- Owner: bb-cli
- License: mit
- Created: 2021-08-09T13:11:26.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2026-04-01T06:03:10.000Z (2 months ago)
- Last Synced: 2026-04-01T08:57:30.006Z (2 months ago)
- Topics: bitbucket, bitbucket-api, bitbucket-cli, cli, php-cli
- Language: PHP
- Homepage: https://bb-cli.github.io
- Size: 685 KB
- Stars: 22
- Watchers: 2
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Bitbucket Rest API CLI
Use Bitbucket from command line. With this app you can see pull request, pipelines, branches etc. from your terminal.

## Installation
__NOTE__: Before install this package, you should have **PHP >= 7** installed on your machine. For an alternative, use Docker instructions below.
* Download standalone binary from [releases](https://github.com/bb-cli/bb-cli/releases)
* Move downloaded file to path like `mv bb /usr/local/bin/bb` or `mv bb ~/.local/bin/bb`
* For testing `bb help`
* Let's move on to the [auth.](https://bb-cli.github.io/authentication)
## Docker Setup
As an alternative to having a PHP runtime installed locally, you can make use of a Docker container to run Bitbucket CLI.
First, make sure to create `~/.bitbucket-rest-cli-config.json` beforehand:
```shell
touch ~/.bitbucket-rest-cli-config.json
```
Then, run the tool:
```shell
docker run -it --rm --mount type=bind,source="$HOME/.bitbucket-rest-cli-config.json",target=/root/.bitbucket-rest-cli-config.json --mount type=bind,source="$(pwd)",target=/workdir,readonly ghcr.io/bb-cli/bb-cli help
```
For ease, configure this as an alias in your chosen shell:
```shell
alias bb='docker run -it --rm --mount type=bind,source="$HOME/.bitbucket-rest-cli-config.json",target=/root/.bitbucket-rest-cli-config.json --mount type=bind,source="$(pwd)",target=/workdir,readonly ghcr.io/bb-cli/bb-cli'
```
Then use `bb help` and `bb auth` as expected in the documentation.
## Usage
[View the documentation](https://bb-cli.github.io) for usage information.
## Development
This tool developed with help of [Github Copilot](https://copilot.github.com) :octocat:
## License
The MIT License (MIT). Please see [License File](LICENSE) for more information.