bit-cm is a CLI written in Nodejs. It help you manager remote branch and pull request by simple command line. This CLI follow Bitbucket API

Feature

• Create branch
• Delete branch
• Reset branch
• Open pull request
• Merge pull request

Install

You need install nodejs. Make sure nodejs was installed ( node>= 12)

$ node -v
$ npm -v

Install bit-cm

$ npm install -g bit-cm

Check bit-cm was installed

$ bcm -v

Uninstall

$ npm uninstall -g bit-cm
$ rm -rf ~/.bcm

Setup your config

• Make sure your basic authentication bitbucket is set up

  $ bcm set --basic-auth-username <username> 
  $ bcm set --basic-auth-password <password> 

• Set default workspace

  $ bcm set --default-workspace <workspace>

• What is a workspace ? A workspace is where you will create repositories, collaborate on your code, and organize different streams of work in your Bitbucket Cloud account. At this time, you'll be provided with one workspace and one workspace ID.

• Check config

  $ bcm get

Comamnd line Document

1. Repositories list

• You can get your repositories list (limit 100 items):

  $ bcm repo

• Or use alias by the way

  # set index
  $ bcm repo --set-index-alias
  # check it
  $ bcm alias
  # or search aliasId by repo name
  $ bcm alias --search "something"

2. Create branch

• This command will create new branch from another source branch, please make sure source branch or default source branch is exist
• Command: bcm new|n <repo|aliasId> <branch> [source]
• Option
  • -w <workspace> or --workspace <workspace>
• Set aliasId follow 1. Repositories list or if you've already done it:

  $ bcm alias 
  #or
  $ bcm a

• Set default source branch:

  # another branch you want, my example is master
  $ bcm set --default-branch-create-from master

• Examples:
  • Full command:

    $ bcm new test-repo test-branch master

  • Short command:

    # if not set default source branch
    $ bcm n 2 test-branch master
    # default source branch has aldready
    $ bcm n 2 test-branch

3. Delete branch

• Command: bcm delete|d <repo|aliasId> <branch>
• Option
  • -w <workspace> or --workspace <workspace>
• Examples:
  • Full command:

    $ bcm delete test-repo test-branch

  • Short command:

    $ bcm d 2 test-branch

4. Reset branch

• This command will delete and recreate branch from another source branch, please make sure source or default source branch is exist
• Command: bcm reset|r <repo|aliasId> [branch] [source]
• Option
  • -w <workspace> or --workspace <workspace>
• Set default source branch. Your branch you want reset will recreate from this:

  # another branch you want, my example is master
  $ bcm set --default-branch-reset-from master

• Set default branch will reset.

  # another branch you want, my example is master
  $ bcm set --default-branch-reset staging 

• Examples:
  • Full command:

    $ bcm reset test-repo test-branch master

  • Short command:

    # if you not set default branch
    $ bcm r 2 test-branch master
    # if default destination branch has aldready
    $ bcm r 2 test-branch
    # if default destination branch and default branch reset has aldready
    $ bcm r 2 # mean delete staging and recreate from master

5. Open pull request

• This command will create pull request your into another branch.
• Command: bcm open|o <repo|aliasId> <branch> [destination]
• Option
  • -w <workspace> or --workspace <workspace>
  • -t <title> or --title <title> if you want set title or not title default is branch name
  • -m or --merge if you want auto merge
• Set default destination

  # another branch you want, my example is master
  $ bcm set --default-branch-open-pull master

• Examples:
  • Full command

    $ bcm open test-repo test-branch master

  • Short command

    # if you not set default branch
    $ bcm o 2 test-branch master
    # if default destination branch has aldready
    $ bcm o 2 test-branch

6. Merge pull request

• This command will merge your pull request by id
• Command: bcm merge|m <repo> <pullId>
• Examples:
  • Full command:

    $ bcm merge test-repo 25

  • Short command:

    $ bcm m test repo 25

End

Thanks for spending your time to visit.