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.

Files for ket, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size ket-0.0.4.tar.gz (5.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page