CLI for interacting with Bitbucket Server

bitbucket-server-cli helps you quickly scan your Bitbucket repositories. Currently it can:

• Audit permissions to ensure all of your repositories are configured similarly
• Finds stale pull requests
• Compiles statistics about pull requests

First thing first, let's make sure you have the necessary pre-requisites.

• Node.js - v6.0.0+
• npm - v3.0.0+

• npm install bitbucket-server-cli -g

Set the following environment variables:

• BITBUCKET_BASE_URL, ex: https://bitbucketserver.myserver.com
• BITBUCKET_USERNAME, ex: username
• BITBUCKET_PASSWORD, ex: password

NOTE: You will need ADMIN permissions to each project/repo you are auditing.

Audits permissions

Alias: ap

Permissions README

Examples bitbucket-server-cli -p "MYPROJECTKEY,MYPROJECTKEY2" -c "./permissionsConfig.json" audit-permissions

bitbucket-server-cli -p "MYPROJECTKEY,MYPROJECTKEY2" -c "./permissionsConfig.json" ap

Please see the Permissions README for additional examples.

Fetches a list of stale pull requests

Alias: sp

Stale PRs README

Examples bitbucket-server-cli -p "MYPROJECTKEY,MYPROJECTKEY2" -s "30 days" stale-prs

bitbucket-server-cli -p "MYPROJECTKEY,MYPROJECTKEY2" -s "30 days" sp

Please see the Stale PRs README for additional examples.

Fetch PRs stats

Alias: s

Pull Request Stats README

Examples bitbucket-server-cli -p "MYPROJECTKEY,MYPROJECTKEY2" -r "30 days" pr-stats

bitbucket-server-cli -p "MYPROJECTKEY,MYPROJECTKEY2" -r "30 days" s

Please see the Pull Request Stats README for additional examples.

Please see CONTRIBUTING.md.

Please see CHANGELOG.md.

Copyright (c) 2017-2020 Thomas Lindner. Licensed under the MIT license.