bash-bucket cli 🌀
Bash Bucket is a command line interface to open repositories, branches, and pull requests in the default browswer for both Bitbucket and Github with either Mecurial or Git as the version control system (VCS).
The purpose of bash-bucket is to efficiently open up current branch details through the terminal window:
$ bb
- open repo in browser$ bb branch
- open current branch$ bb commits
- open branch commit history$ bb compare [branch]
- open and compare current branch to optional argument$ bb issues
- go to issues in browser$ bb info
- get branch and repo information about current directory$ bb pr
- open a pull request from current branch$ bb repo
- open repo in browser
NPM
Installation on$ npm i bash-bucket -g # installs as global CLI
Boom, now you can use all the bash-bucket commands! 💥
All commands are fully explained below ⬇️
Commands
branch
Open current branch in browser
$ cd directory/to/current-project
$ bb branch [branch] # open specific branch as optional parameter rather than current
commits
Open current branch commit history in browser
$ cd directory/to/current-project
$ bb commits
compare
Compare current branch as source to a destination branch
$ cd directory/to/current-project
# Replace 'branch' with branch you want to compare current branch to
$ bb compare [branch]
# -- OR --
# By default, this function will compare current branch to 'develop'
$ bb compare
info
Get branch/repo information returned in terminal window
$ cd directory/to/current-project
$ bb info
issues
Opens browser to current issues
$ cd directory/to/current-project
$ bb issues
pr
Opens browser to create a pull request in Bitbucket
$ cd directory/to/current-project
$ bb pr
repo
Open current branch in Bitbucket
$ cd directory/to/current-project
$ bb
# -- OR --
$ bb repo
Credit/inspiration:
- Open Bitbucket from Bash by Steve Posh
- An introduction to useful bash aliases and functions by Justin Ellingwood @ DigitalOcean
- gh-home by Sindre Sorhus