English | 繁體中文 | 한국어

bw-fzf-copy

A terminal utility to quickly search and copy Bitwarden vault items using fzf.

Features

• Fuzzy search through the Bitwarden vault.
• Copy passwords or usernames directly to the clipboard.
• Non-persistent session management.

Installation

Via Homebrew (Recommended)

brew tap yozlog/tap
brew install bw-fzf-copy

After installation, the tool can be executed using the bwfzfcp command.

Manual Installation

1. Clone the repository

mkdir -p ~/scripts
git clone https://github.com/yozlog/bw-fzf-copy.git ~/scripts/bw-fzf-copy

2. Grant execution permission

chmod +x ~/scripts/bw-fzf-copy/main.sh

Requirements

This script depends on the Bitwarden CLI (bw), fzf, and jq. If installed manually, these dependencies must be installed separately.

macOS

Can be installed via Homebrew:

brew install bitwarden-cli fzf jq

Security Note (Important)

Warning

This script caches the Bitwarden session key in a temporary file (/tmp/bw_session_global_${USER}) to avoid repeated password prompts. For security reasons, only use this script on private and secure machines.

Usage

Via Homebrew

If installed via Homebrew, simply run:

bwfzfcp

Standalone

Navigate to the script directory (adjust the path to match the storage location):

cd ~/scripts/bw-fzf-copy

./main.sh

Shell Alias

For more convenient access, an alias can be added to the shell configuration.

zsh

Add to the .zshrc:

alias bwfzfcp='~/scripts/bw-fzf-copy/main.sh'
# You can change `bwfzfcp` to a preferred alias

Terminal Keybinding

A global keybinding can be configured to trigger the script.

Ghostty

Add to the config file:

keybind = ctrl+shift+b=text:bwfzfcp\n
# Use 'bwfzfcp' if installed via Homebrew, or the full path to the script if installed manually