7 releases (1 stable)

1.0.0 Sep 26, 2024
0.5.0 Apr 26, 2024
0.4.0 Dec 21, 2023
0.3.1 Oct 13, 2023
0.1.0 Mar 20, 2023

#142 in Authentication

Download history 4/week @ 2024-09-05 10/week @ 2024-09-12 9/week @ 2024-09-19 163/week @ 2024-09-26 24/week @ 2024-10-03 8/week @ 2024-10-10 10/week @ 2024-10-17 11/week @ 2024-10-24 23/week @ 2024-10-31 26/week @ 2024-11-07 22/week @ 2024-11-14 21/week @ 2024-11-21

95 downloads per month

Custom license and LGPL-3.0-or-later

75KB
1.5K SLoC

Rust 1.5K SLoC // 0.0% comments Shell 148 SLoC // 0.0% comments PowerShell 91 SLoC

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.

Install

We offer three ways to install bws:

Cargo (crates.io)

Download bws via cargo from crates.io:

cargo install bws --locked

Install Script (from GitHub Releases)

Linux/macOS: curl https://bws.bitwarden.com/install | sh

Windows: iwr https://bws.bitwarden.com/install | iex

An optional -u/--uninstall flag can be passed to the POSIX script to uninstall the CLI. The PowerShell version accepts an equivalent -Uninstall flag. The uninstallation process will remove the bws binary and the configuration directory (~/.bws).

GitHub Releases (Manual)

Download a pre-built binary from the Releases page.

Usage

bws --help

How to enable shell autocompletions

Zsh

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

Bash

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.

Docker

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

How to build manpages

The manpages get built during compilation of the bws crate through the use of a build script. The output path of this build script can be located as follows:

MANPAGES_DIR=$(cargo build -p bws --message-format json | jq -r --slurp '.[] | select (.reason == "build-script-executed") | select(.package_id|contains("crates/bws")) .out_dir')

After running the provided commands, the built manpages should be located in $MANPAGES_DIR/manpages

Dependencies

~44–67MB
~1M SLoC