rbwzf 🔐

A fuzzy finder (fzf) wrapper for rbw (Rust Bitwarden) to manage your Bitwarden vault via the command line.

🚀 Features

• 🔍 Interactive fuzzy search through your Bitwarden entries
• 📋 Copy passwords, usernames, and OTP codes to clipboard
• 🔓 Automatic vault unlocking and syncing
• ⚙️ Bootstrap setup for email and server URL
• 🖥️ Support for Wayland (wl-copy) and X11 (xclip) clipboards
• 🔄 One-time or persistent TUI modes
• 🔔 Notification support (for debugging, insecure)
• 💾 Persistent last entries cache (stored in ~/.cache/rbwzf/)

📦 Installation

1. Install dependencies:

   • rbw (Rust Bitwarden CLI)
   • fzf (fuzzy finder)
   • jq (JSON processor)
   • wl-copy (Wayland) or xclip (X11) for clipboard

2. Clone or download the repository

3. Make the script executable: chmod +x rbwzf.sh

4. Run ./rbwzf.sh to start

💻 Usage

./rbwzf.sh [options]

Options

Flag	Description
-o	One-time mode (select and copy once, then exit)
-s	Static TUI mode (persistent menu, default)
-n	Enable notifications (insecure, exposes copied content)
-c	Disable cache
-u	Unsecure mode (don't lock vault on exit)
-h	Display help message

Menu Options

• 📂 Entries: Browse and select from your vault entries
• ➕ Add: (Not implemented yet)
• ➖ Remove: (Not implemented yet)
• 🕒 Last: Access recently used entries
• 🚪 Quit: Exit the application

Selecting Items

1. 🔍 Choose an entry from the list
2. 📋 Select what to copy: Username, Password (masked), or OTP
3. ✨ Item is copied to clipboard automatically

🔧 Dependencies

• rbw: Rust implementation of Bitwarden CLI
• fzf: Command-line fuzzy finder
• jq: Lightweight JSON processor
• Clipboard tool: wl-copy (Wayland) or xclip (X11)

⚠️ Security Notes

• 🔒 Vault is automatically locked on exit (unless -u flag used)
• 🔔 Notifications (-n) expose copied content and should only be used for debugging
• ✅ Ensure your system has the required dependencies installed

🔮 Future Features

• ➕ Add new entries
• ➖ Remove existing entries
• ✏️ Edit entry details