/tmux-bitwarden

Access your Bitwarden login items within tmux

Primary LanguageShell

tmux-bitwarden

Requirements

You need to have:

Install

Tmux Plugin Manager (recommended)

  1. In your .tmux.conf add the plugin to the list.
set -g @plugin 'Alkindi42/tmux-bitwarden'
  1. Type prefix + I to install the plugin.

Key bindings

  • prefix + b: list login items in a bottom pane.

Usage

First, log into your Bitwarden user account using the login command (you only need to do this once):

$ bw login your-email@domain.com
? Master password: [input is hidden]
To unlock your vault, set your session key to the `BW_SESSION` environment variable. ex:
$ export BW_SESSION="lpvf7Rt+pAMXW2YJ5O42jJp6ZY0Ny01vq9jaUdFYbroS1CXWgjVdy7j42owHVoLwZf+yDI+ro68Qngo9mdD/vA=="
> $env:BW_SESSION="lpvf7Rt+pAMXW2YJ5O42jJp6ZY0Ny01vq9jaUdFYbroS1CXWgjVdy7j42owHVoLwZf+yDI+ro68Qngo9mdD/vA=="

In a tmux session, you can run the plugin with the default key binding prefix + b. This opens a new pane at the bottom with login items. You can choose your login item with <Enter>, your password will be automatically filled.

If you have not configured your bitwarden session (BW_SESSION), you will be prompted to re-enter your master password before each selection (see configuration section for more information)

Configuration

Changing the default key-binding

set -g @bw-key 'T'

Default: u

Define Bitwarden session

To avoid re-entering your master password before each selection, you can define your session Bitwarden. Your BW_SESSION comes from the result of the login command.

set -g @bw-session 'BW_SESSION'

If the BW_SESSION variable exists in your environment variable then it will be used.

Copy the password to the clipboard

By default, after selection, the password is sent in the last pane. If you want to have it in your clipboard you have to activate the option:

set -g @bw-copy-to-clipboard 'on'

Default: off