Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elogiclab/zsh-bws
Zsh plugin for Bitwarden Secret Manager Cli
https://github.com/elogiclab/zsh-bws
antigen bitwarden bitwarden-cli bws fzf oh-my-zsh zsh zsh-plugin
Last synced: 15 days ago
JSON representation
Zsh plugin for Bitwarden Secret Manager Cli
- Host: GitHub
- URL: https://github.com/elogiclab/zsh-bws
- Owner: elogiclab
- License: mit
- Created: 2024-10-03T11:04:30.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-04T18:10:46.000Z (2 months ago)
- Last Synced: 2024-10-14T21:21:51.047Z (about 2 months ago)
- Topics: antigen, bitwarden, bitwarden-cli, bws, fzf, oh-my-zsh, zsh, zsh-plugin
- Language: Shell
- Homepage:
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- trackawesomelist - bws (⭐0) - Simplify and improve the retrieval of secrets from the [Bitwarden](https://bitwarden.com) Secret Manager. (Recently Updated / [Oct 06, 2024](/content/2024/10/06/README.md))
README
# zsh-bws
This plugin provides a collection of features to simplify and improve the retrieval of secrets from Bitwarden Secret Manager.
## Installation
See [INSTALL.md](INSTALL.md).
## Usage
### bws_get
```
bws_get [-i secret_id | -k secret_key ]
```
Gets the secret value by id or key and prints it to the standard output. If neither id nor key is specified, the function asks to select from the list of all secrets present on the server.
### bws_get_full
```
bws_get_full [-i secret_id | -k secret_key ] [-o output_format ]
```
Gets the entire secret by id or key and prints it to the standard output with the indicated format. If none of id or key is indicated the function asks to select from the list of all secrets present on the server.
The supported formats are the same as the bws command, namely: json, yaml, env, table, tsv, none. The default is json.
### bws_copy
```
bws_copy [-i secret_id | -k secret_key ]
```
Gets the secret value by id or key and copy it to the clipboard. If neither id nor key is specified, the function asks to select from the list of all secrets present on the server.
To copy to the clipboard it uses the clipboard command. You can customize the command via the ZSH_BWS_COPY_CMD variable.
## Alias
| Alias | Command |
| --- | --- |
| `bwsg` | `bws_get` |
| `bwsgf` | `bws_get_full` |
| `bwsc` | `bws_copy` |
| `bwsl` | `bws secret list` |
## Examples
### Add a ssh key to ssh agent
On Bitwarden Secret Manager you can save ssh keys. With this trick you can easily add your private key to the agent by selecting it among your secrets and without it residing on the computer disk.
```
ssh-add - <<< $(bwsg)
```