YubiKey Manager CLI

Python library and command line tool for configuring a YubiKey. If you’re looking for the full graphical application, which also includes the command line tool, it’s here.

This project is in BETA. Any part of the application may change before the next release, and some functionality and documentation is missing at this point.


Usage: ykman [OPTIONS] COMMAND [ARGS]...

  Configure your YubiKey via the command line.

  -v, --version
  -h, --help     Show this message and exit.

  info     Show general information.
  mode     Manage connection modes.
  oath     Manage YubiKey OATH credentials.
  openpgp  Manage YubiKey OpenPGP functionality.
  piv      Manage YubiKey PIV functionality.
  slot     Manage YubiKey Slots.



sudo apt-add-repository ppa:yubico/stable
sudo apt update
sudo apt install yubikey-manager


brew install ykman

Or from source:

brew install swig ykpers libu2f-host libusb
pip install --user yubikey-manager


The command line tool is installed together with the GUI version of YubiKey Manager.


pip install yubikey-manager

In order for the pip package to work libu2f-host, ykpers and libusb need to be installed on your system as well. Pyscard is also needed in some form, and if it’s not installed pip builds it using swig and potentially PCSC lite.

Bash completion

Experimental Bash completion for the command line tool is available, but not enabled by default. To enable it, run this command once:

source <(_YKMAN_COMPLETE=source ykman | sudo tee /etc/bash_completion.d/ykman)