6 releases (breaking)

0.5.0 Apr 26, 2024
0.4.0 Dec 21, 2023
0.3.1 Oct 13, 2023
0.3.0 Jul 26, 2023
0.1.0 Mar 20, 2023

#50 in Authentication

Download history 14/week @ 2024-01-23 3/week @ 2024-02-13 31/week @ 2024-02-20 13/week @ 2024-02-27 20/week @ 2024-03-05 14/week @ 2024-03-12 2/week @ 2024-03-19 2/week @ 2024-03-26 17/week @ 2024-04-02 146/week @ 2024-04-23 14/week @ 2024-04-30 7/week @ 2024-05-07

167 downloads per month

Custom license and LGPL-3.0-or-later


Bitwarden Secrets Manager CLI

A Rust CLI for interacting with the Bitwarden Secrets Manager. This is a beta release and might be missing some functionality.


cargo install bws

Or download a pre-built binary from the Releases page.


bws --help

How to enable shell autocompletions


If completion is not enabled already, you need to enable it first:

echo "autoload -U compinit; compinit" >> ~/.zshrc

Enable autocompletions for the current user:

echo 'source <(/path/to/bws completions zsh)' >> ~/.zshrc


Enable autocompletions for the current user:

echo 'source <(/path/to/bws completions bash)' >> ~/.bashrc

For more detailed documentation, please refer to the Secrets Manager CLI help article.


We also provide a docker image preloaded with the bws cli.

# From the root of the repository
docker build -f crates/bws/Dockerfile -t bitwarden/bws .

docker run --rm -it bitwarden/bws --help

To use a configuration file, utilize docker bind mounting to expose it to the container:

docker run --rm -it -v "$HOME"/.bws:/home/app/.bws bitwarden/bws --help


~1M SLoC