A minimal bitwarden-cli wrapper.
Inspired by this article and shellsec.
- bitwarden-cli
- jq - json parser
- [xsel] - clipboard manager; see clipboard
bwbb.sh [options] <search_term>
Wrapper for bw(bitwarden-cli). Use to search for a login info, and to
copy credentials to clipboard. Use options to generate passwords.
arguments:
search_term A string corresponding to what login info you want to search for
options:
-g Generate a password [default 15 characters]; overriden by -l
-n Don't use special characters
-p Generate a passphrase [default 3 words]; overriden by -l
-c Copy output (from generation) to clipboard
-l <len> Override length for password and passphrase with <len>
-h Show this help text
To get credentials:
$ bwbb <search-term>
? Master password: [hidden]
Multiple matches:
0) option-one
1) option-two
2) option-three
Choose only one: 1
Username in clipboard
Press any key to copy password...
Password copied!
To generate a password:
$ bwbb -gl 15
Generated password:
*9j@%opq&N8BQyX
To generate a pass-phrase:
$ bwbb -pl 5
Generated password:
Bobsled-Scrawny-Rockiness-Fang1-Shorthand
Use the -c option to copy to clipboard
$ bwbb -pl 5 -c
Password copied to your clipboard
As stated, this script is just a bitwarden-cli wrapper. It offers minimal flexibility to simplify usage and maximize security. Thus, for password generation, uppercase, lowercase, numbers and symbols are used by default. You can opt-in to not use symbols. Also, for passphrases all words are capitalized and one number is included. For both, the length can be customized, but by default a password will be 15 characters in length and a passphrase will span 3 words.
By default you have to input your account password for every use (excluding generation). However, there are multiple login options that you can read about in the official documentation
By default bwbb uses xsel to save output to your clipboard. You can use whatever clipboard manager you like by setting the BWBB_CLIPBOARD environment variable to the full command that receives input from stdin and saves it to the default clipboard. You can make this permanent by setting the variable into your shell init file.
BWBB_CLIPBOARD='xclip -selection clipboard -i'