Awesome
tmux-bitwarden
Requirements
You need to have:
- Bitwarden CLI
- jq
- fzf
- bash > 4.0
Install
Tmux Plugin Manager (recommended)
- In your
.tmux.conf
add the plugin to the list.
set -g @plugin 'Alkindi42/tmux-bitwarden'
- 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