aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md24
1 files changed, 22 insertions, 2 deletions
diff --git a/README.md b/README.md
index 84c36f1..988ac75 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,16 @@ You can download a Debian package from
[`minisign`](https://github.com/jedisct1/minisign), and can be verified using
the public key `RWTM0AZ5RpROOfAIWx1HvYQ6pw1+FKwN6526UFTKNImP/Hz3ynCFst3r`.
+### Homebrew
+
+`rbw` is available in the [Homebrew repository](https://formulae.brew.sh/formula/rbw). You can install it via `brew install rbw`.
+
+### Nix
+
+`rbw` is available in the
+[NixOS repository](https://search.nixos.org/packages?show=rbw). You can try
+it out via `nix-shell -p rbw`.
+
### Alpine
`rbw` is available in the [testing repository](https://pkgs.alpinelinux.org/packages?name=rbw).
@@ -45,7 +55,7 @@ If you are not using the `edge` version of alpine you have to [enable the reposi
### Other
With a working Rust installation, `rbw` can be installed via `cargo install
-rbw`. This requires that the
+--locked rbw`. This requires that the
[`pinentry`](https://www.gnupg.org/related_software/pinentry/index.en.html)
program is installed (to display password prompts).
@@ -74,6 +84,14 @@ configuration options:
[pinentry](https://www.gnupg.org/related_software/pinentry/index.html)
executable to use. Defaults to `pinentry`.
+### Profiles
+
+`rbw` supports different configuration profiles, which can be switched
+between by using the `RBW_PROFILE` environment variable. Setting it to a name
+(for example, `RBW_PROFILE=work` or `RBW_PROFILE=personal`) can be used to
+switch between several different vaults - each will use its own separate
+configuration, local vault, and agent.
+
## Usage
Commands can generally be used directly, and will handle logging in or
@@ -95,7 +113,9 @@ functionality.
Run `rbw get <name>` to get your passwords. If you also want to get the username
or the note associated, you can use the flag `--full`. You can also use the flag
`--field={field}` to get whatever default or custom field you want. The `--raw`
-flag will show the output as JSON.
+flag will show the output as JSON. In addition to matching against the name,
+you can pass a UUID as the name to search for the entry with that id, or a
+URL to search for an entry with a matching website entry.
*Note to users of the official Bitwarden server (at bitwarden.com)*: The
official server has a tendency to detect command line traffic as bot traffic