Skip to main content

Bitbucket workflows in your terminal

Project description

Build Status


ket is a command-line tool, that makes interaction with Bitbucket repositories easier.

You probably know hub for GitHub and/or lab for GitLab. Well, ket is trying to accomplish the same goal, but for Bitbucket.

ket is currently only capable of managing pull requests. More to come!


$ pip install ket


In order to interact with a Bitbucket repository, ket needs to authenticate to Bitbucket with a username and an API key. The username is usually your Bitbucket username. For the API key you should use the so-called app password. More on app passwords, and how to create them here.

Configuration file

ket tries to read its configuration from the file $HOME/.config/ket, which must be formatted as follows:

username = Ch00k
api_key = <app_password>


$ ket
Usage: ket [OPTIONS] COMMAND [ARGS]...

  Bitbucket in your command-line

  --help  Show this message and exit.

  pull-request  Pull request operations
$ ket pull-request
Usage: ket pull-request [OPTIONS] COMMAND [ARGS]...

  Pull request operations

  --help  Show this message and exit.

  approve    Approve a pull request
  checkout   Checkout the branch of a pull request
  close      Close (decline) a pull request
  create     Create a pull request
  diff       Show the diff of a pull request
  list       List pull requests
  merge      Merge (accept) a pull request
  show       Show pull request details
  unapprove  Unapprove a pull request

Tab completion

To enable tab completion, execute

eval "$(_KET_COMPLETE=source ket)"

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ket-0.0.4.tar.gz (5.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page