bt-tui

A terminal UI for browsing Bitwarden vault items with Rust + ratatui.

Current v1 slice

• Multi-pane TUI layout (folders, item list, detail view, status/footer)
• Keyboard navigation and focus switching
• In-app Bitwarden login screen (server/email/master password)
• Bitwarden CLI adapter (bw config, bw login, bw unlock, bw list/create/edit/delete)
• Clipboard copy shortcuts for username/password
• In-app Add/Edit/Delete item workflows
• Folder sidebar loaded from Bitwarden (bw list folders) with nesting support
• Detail panel now includes custom fields from each vault item

Run

cargo run

Connect your Bitwarden account

1. Launch bt-tui with cargo run.
2. On the login screen, fill:
   • Server (e.g. https://vault.bitwarden.com, https://vault.bitwarden.eu, or your self-hosted URL)
   • Email
   • Master Password
3. Press Enter to authenticate and load your vault.

If login/unlock fails, the exact CLI error is shown in the status line.

If bw works in your shell but bt-tui cannot find it, set:

export BT_TUI_BW_BIN="/full/path/to/bw"

Note: this flow currently targets email + master password auth. Complex 2FA/provider login scenarios may still require handling with bw directly first.

Keybindings

• Ctrl+Q: Quit from anywhere
• Ctrl+C: Quit from anywhere
• Login screen:
  • Tab, Up/Down: Move between fields
  • Any printable key: Type into selected field
  • Backspace: Delete from selected field
  • Enter: Submit login
• Tab / Shift+Tab: Cycle focus
• h/l or left/right arrows: Move focus
• j/k or up/down arrows: Move selection
• Sidebar focus now navigates folders
• r: Reload from Bitwarden
• i: Open login screen from vault view
• u: Copy selected username
• y: Copy selected password
• Ctrl+Shift+A: Add item
• Ctrl+Shift+E: Edit selected item
• Ctrl+Shift+D: Delete selected item
• CRUD modal controls:
  • Tab/Up/Down: Move field
  • Enter: Submit action
  • Esc: Cancel

Notes

Current CRUD flow focuses on login-type entries (name, username, password, URI, notes).