Example Commands

Example Commands:

(1) Login to bitbucket.

• bitbucket login

(2) Logout bitbucket & remove saved credentials.

• bitbucket logout

(3) Create New Repository.

• bitbucket repo create -r -d "repo description" -p true -s git -i true -w true

  • -r = repository name (Required)
  • -d = repository description (Optional)
  • -p = private repository (options= true or false) (Optional)
  • -s = repository scm (options= git or hg) (Optional)
  • -i = add issues module (options= true or false) (Optional)
  • -w = add wiki module (options= true or false) (Optional)

(4) List repository associated with account.

• bitbucket repo list

(5) Get individual repository detail.

• bitbucket repo detail -r

  • -r = repository name (Required)

(6) Edit repository details.

• bitbucket repo edit -a -r -d "repo description" -p true -s git -i true -w true -l

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -d = repository description (Optional)
  • -p = private repository (options= true or false) (Optional)
  • -s = repository scm (options= git or hg) (Optional)
  • -i = add issues module (options= true or false) (Optional)
  • -w = add wiki module (options= true or false) (Optional)
  • -l = repository programming language (Ex: python) (Optional)

(7) Delete repository

• bitbucket repo delete -a -r

  • -a = repository account name (Required)
  • -r = repository name (Required)

(8) Fork repository

• bitbucket repo fork -a -r -n -d "repo description" -p true -l

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -d = repository description (Optional)
  • -p = private repository (options= true or false) (Optional)
  • -l = repository programming language (Ex: python) (Optional)

(9) List repository branches

• bitbucket repo branch -a -r

  • -a = repository account name (Required)
  • -r = repository name (Required)

(10) Get list of changeset

• bitbucket repo changeset -a -r -l -s

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -l = limit the number of changeset (Required)
  • -s = start node or starting commit id or commit hash. (Optional)

(11) Get repository tags

• bitbucket repo tag -a -r

  • -a = repository account name (Required)
  • -r = repository name (Required)

(12) Get list of users repository shared with

• bitbucket repo share -a -r

  • -a = repository account name (Required)
  • -r = repository name (Required)

(13) Share repository with other users

• bitbucket repo share-with -a -r -s <share_with> -p

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -s = share repository with user (Required)
  • -p = repository permissions (options= read,write,admin) (Required)

(14) Remove users access to repository

• bitbucket repo share-remove -a -r -s <share_with>

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -s = share repository with user (Required)

(15) Get repository revision details

• bitbucket repo revision -a -r -R -p

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -R = repository revision or branch name (Ex: master) (Required)
  • -p = path to the file or directory to check revision (Ex: bitbucket/issues.py) (Optional)

(16) Get list of repository deployment keys

• bitbucket deploykey-list -a -r

  • -a = repository account name (Required)
  • -r = repository name (Required)

(17) Add new repository deployment key

• bitbucket deploykey -a -r -k "Key" -l

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -k = ssh key (Required)
  • -l = ssh key label or name (Required)

(18) Edit existing repository deployment key

• **bitbucket repo deploykey-edit -a -r -k "Key" -l -i **

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -k = ssh key (Required)
  • -l = ssh key label or name (Required)
  • -i = ssh key id (Required)

(19) Delete existing repository deployment key

• bitbucket repo deploykey-delete -a -r -i

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -i = ssh key id (Required)

(20) Get list of issues

• bitbucket issue -a -r -l -s -k -p -R <reported_by> -I <is_spam> -S <search_string>

(21) Get individual issue details

• **bitbucket issue -a -r -i <issue_id> **

(22) Get issue followers

• bitbucket issue -a -r -i <issue_id> -F

(23) Export issue list to CSV file

• bitbucket -a -r -l -s -k -p -R <reported_by> -x

  • -a = repository account name (Required)

  • -r = repository name (Required)

  • -l = limit the number of issue to get (0-50) default is 15. (Optional)

Filtering parameters (Optional): * -s = issue status (Ex: new) * -k = issue kind (Ex: bug) * -p = issue priority (Ex: major) * -R = issue reported by (Ex: username) * -I = list issues marked as spam (options=true,false) * -S = filter issues based on search string in title * -x = export details to csv file (Only works with issue list command (see example: 23))

(24) Create new issue

• bitbucket issue create -a -r -t <title> -d -s -k -p -R -C -m -v

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -t = issue title (Required)
  • -d = issue content (Optional)
  • -s = issue status (Ex: new) (Optional)
  • -k = issue kind (Ex: bug) (Optional)
  • -p = issue priority (Ex: major) (Optional)
  • -R = issue assigned to (Ex: username) (Optional)
  • -C = issue component (Optional)
  • -m = issue milestone (Optional)
  • -v = repository version (Optional)

(25) Edit issue

• bitbucket issue create -a -r -i <issue_id>-t <title> -d -s -k -p -R -C -m -v

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -i = issue id (Required)
  • -t = issue title (Optional)
  • -d = issue content (Optional)
  • -s = issue status (Ex: new) (Optional)
  • -k = issue kind (Ex: bug) (Optional)
  • -p = issue priority (Ex: major) (Optional)
  • -R = issue assigned to (Ex: username) (Optional)
  • -C = issue component (Optional)
  • -m = issue milestone (Optional)
  • -v = repository version (Optional)

(26) Delete issue

• bitbucket issue delete -a -r -i <issue_id>

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -i = issue id (Required)

(27) Get all comments for issue

• bitbucket issue getcomment -a -r -i <issue_id>

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -i = issue id (Required)

(28) Add new comment for issue

• bitbucket issue getcomment -a -r -i <issue_id> -c

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -i = issue id (Required)
  • -c = issue comment content (Required)

(29) Get list of all ssh keys associated with users account

• bitbucket sshkey -a

  • -a = repository account name (Required)

(30) Get individual sshkey from key id

• bitbucket sshkey -a -i <sshkey_id>

  • -a = repository account name (Required)
  • -i = sshkey id (Required)

(31) Add new ssh key to users account

• bitbucket add -a -k "sshkey" -l

  • -a = repository account name (Required)
  • -k = sshkey (Required)
  • -l = sshkey label (Required)

(32) Delete ssh key from account

• bitbucket sshkey delete -a -i <sshkey_id>

  • -a = repository account name (Required)
  • -i = sshkey id (Required)

(33) Get logged in user information

• bitbucket user info

(34) Get logged in user privileges

• bitbucket user privileges

(35) Get wiki page created for repository

• bitbucket wiki get -a -r -p

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -p = wiki page name (Ex: home) (Required)

(36) Post new wiki page for repositorys

• bitbucket wiki get -a -r -p -c "wiki page content"

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -p = wiki page name (Ex: home) (Required)
  • -c = wiki page content (Required)

(37) Get list groups & respective members

• bitbucket groups -a

(38) Add new member in group

• bitbucket group member-add -a -n -m

  • -a = account name (Required)
  • -n = name of group (Required)
  • -m = name of username (Required)

(39) Delete member from group

• bitbucket group member-delete -a -n -m

  • -a = account name (Required)
  • -n = name of group (Required)
  • -m = name of username (Required)

(40) Create new group

• bitbucket group create -a -n -p

  • -a = account name (Required)
  • -n = name of group (Required)
  • -p = permission (options: read,write,admin) (Required)

(41) Delete existing group

• bitbucket group delete -a -n

  • -a = account name (Required)
  • -n = name of group (Required)

(42) Get commit details from commit id

• bitbucket commit detail -a -r -c

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -c = commit id (Required)

(43) Get comments for changeset

• bitbucket commit detail -a -r -c

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -c = commit id (Required)

(44) Add new comment for changeset

• bitbucket commit detail -a -r -c

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -c = commit id (Required)
  • -C = comment contents (Required)

(45) Delete comment for changeset

• bitbucket commit detail -a -r -c -id

  • -a = repository account name (Required)
  • -r = repository name (Required)
  • -c = commit id (Required)
  • -C = comment id (Required)