A blazing fast, zero-bloat, and security-first Bitwarden / Vaultwarden overlay for Omarchy Shell on Hyprland.
Powered by a dedicated pure Rust engine (omawarden), omarchy-bitwarden delivers sub-millisecond credential lookups, minimal memory overhead, and rigorous process isolation—designed from the ground up to replace heavy Electron apps and sluggish Node CLI tooling with a native, Spotlight-style keyboard workflow.
| Dimension | omarchy-bitwarden (omawarden) |
Official Desktop App (Electron) | Official CLI (bw) |
|---|---|---|---|
| Response Latency | Sub-millisecond (resident in-memory IPC socket) | Slow UI render (1.5s - 3s) | Heavy Node.js startup delay |
| Memory Footprint | Lightweight resident daemon (~5–15MB idle / ~64MB transient Argon2id peak) | 500MB - 1GB+ Chromium bloat across multiple child processes | Transient, high peak memory (~80MB-120MB) |
| Process Security | Zero-leakage (protected stdin & 0600 socket) | Broad webview memory exposure | Secrets prone to argv/ps snooping |
| Token & Secret Storage | System Keyring Isolation (0 plaintext tokens in local cache) | Desktop Keychain / Electron store | Stored in plaintext cache file or relies on insecure, leak-prone BW_SESSION env export |
| Local Data Caching | Zero-Knowledge Ciphertext Cache (fast offline search, no tokens) | Local cache file mixed with session tokens | Local cache file mixed with session tokens |
| Token Expiry Handling | Master Password Unlock Only (Keyring renews tokens silently; never forces API Key re-login) | Desktop app preserves login; prompts for master password | Hard 2-hr expiry (Session expired); forces manual CLI re-login |
| Lock-Screen Sync | Native daemon auto-detection (Omarchy lock, Hyprlock, D-Bus/logind, sleep) | App idle timeout only | None (manual lock required) |
| SSH Agent | Native OpenSSH Agent (SSH_AUTH_SOCK) with app-scoped approval cards |
Built into desktop app (eats ~1GB RAM) | None |
| System Quick Unlock | Native Polkit / Biometrics integration (unlock via fingerprint or system password after soft-lock; user key retained in mlock memory; wiped on hard lock/suspend) |
Desktop biometrics (requires heavy Electron app resident) | None (always prompts for master password) |
| Desktop Theming & Palette | Dynamic Adaptive Theming (Commons.Color + StatusPalette) (zero hardcoded colors; seamless dark/light switching; WCAG contrast compliant) |
Standard Dark/Light toggle | None (terminal only) |
| Mutual TLS (mTLS) | Native client cert authentication (PKCS#12 / PEM) | Requires system proxy configuration | None |
| Runtime Dependencies | 100% standalone binary (Zero external deps) | Full Chromium/Node runtime | Node.js environment required |
| Tool / Component | Resident Memory (RSS) | Process Count | Search / Query Latency | Cold Start Latency | UI / Integration Type |
|---|---|---|---|---|---|
omawarden daemon + overlay |
~5 – 15 MB (idle base; ~64MB transient during Argon2id derivation) | 1 daemon (+ ephemeral overlay) | < 1 ms (IPC socket) | < 5 ms | Hardware-accelerated Wayland QML |
rbw (Unofficial Rust CLI) |
~5 – 10 MB | 1 daemon | < 5 ms (Unix socket) | < 5 ms | None (CLI terminal output only) |
| Official Bitwarden Desktop | ~500 MB – 1 GB+ | 8 – 12 processes (GPU, Webview, Utility, Crashpad) | 1.5s – 3s | 2s – 4s | Heavy Electron / Chromium Window |
Official CLI (bw) |
~80 MB – 120 MB | 1 process per call | 300 ms – 800 ms | 300 ms – 800 ms | None (Node.js runtime boot per invocation) |
Note
Why this matters: In tiling window managers like Hyprland, background utilities should not occupy hundreds of megabytes or gigabytes of memory just to serve SSH agent keys or look up credentials. omawarden stays dormant at ~5–15MB RSS, responds to IPC queries under 1ms, and strictly zeroizes sensitive decrypted buffers upon completion or lock.
rbw is an outstanding unofficial Rust CLI client in the Linux ecosystem that pioneered a zero-knowledge resident daemon architecture, serving as a major inspiration for omawarden. Both tools uphold high standards for cryptographic memory safety, featuring physical memory locking (mlock) and immediate memory zeroization (zeroize).
The difference between them is not "CLI vs Desktop", but rather the distinct design trade-offs made across feature completeness, system dependencies, and workflows:
| Dimension | omawarden (Native Engine & Standalone CLI) |
rbw (Unofficial Rust CLI) |
|---|---|---|
| Item Type Support Depth | First-Class 5 Types: Dedicated extraction flags and structured UI inspection for Logins, Cards (CVV/number), Identities, Notes, and SSH Keys | Primarily targets password and TOTP; viewing cards/identities requires dumping unformatted raw JSON (--raw) |
| OpenSSH Agent Capabilities | Vault-Backed Agent (SSH_AUTH_SOCK) + Key Generation: Keys parsed only for single signature and zeroized; on-demand overlay unlock; per-app approval scoping (first-use), and interactive confirmation card with 600ms anti-misclick protection |
Agent Proxy: Implements SSH_AUTH_SOCK to sign in-memory; lacks keypair generation, approval confirmation prompts, and per-app authorization scoping |
| Mutual TLS (mTLS) Reverse Proxy | Native Support: Authenticates to Vaultwarden/Bitwarden behind mTLS reverse proxies (PKCS#12 .p12/.pfx and PEM .crt/.key) with keyring-isolated passphrases |
Not supported |
| System Quick Unlock | Polkit & Biometrics Integration: Soft locks retain the user key in mlock memory; unlocks with fingerprint or system login password. Hard locks (suspend, session ceiling, logout, 3 failed attempts) wipe the key |
Not supported (requires master password on every unlock) |
| Adaptive UI Theming | Native StatusPalette & Token System: Seamless dark/light Omarchy theme adaptation with zero hardcoded colors and strict WCAG contrast compliance | Not applicable (pure CLI tool without GUI) |
| Password & Passphrase Generator | Dual Engine (GUI & CLI): Interactive PasswordGeneratorModal.qml with length/charset/entropy controls + Diceware word count/separators + omawarden generate with Wayland clipboard auto-clear guard |
rbw gen CLI only (no GUI modal or Diceware passphrase support) |
| Attachment Decryption | Native: Downloads encrypted blobs and decrypts binary payloads via AES-256-CBC for preview/export |
Not supported (see open feature request doy/rbw#130) |
| Password Revision History | Native: Decrypts and displays item password revision history | Not supported |
| Organizations & Collections | Full Support: RSA-OAEP-SHA1 Org key unwrapping, Multi-Org & Collection filtering |
Basic Support: Focused on personal vault; limited organization & collection support (doy/rbw#351) |
| Lock Screen Security Integration | Active Zeroize on Lock: Listens to Hyprlock, Omarchy lock, D-Bus logind sleep/lock signals |
Passive Idle Timeout: Secrets remain in memory during sleep/lock if idle timer hasn't expired |
| Authentication & Secret Storage | System Keyring (Secret Service) Integration: Silent background token renewal without interrupting workflow | GnuPG / pinentry Interaction: Standard pinentry (supports TTY pinentry-curses); independent of desktop keyring |
| GUI IPC Integration | Dedicated Structured JSON IPC Socket: Designed for high-throughput, instant desktop overlay rendering (<1ms) | Plain text stdout/stderr intended for terminal pipelines |
In the following scenarios, rbw holds clear advantages, allowing users to choose the best fit for their workflow:
- Distribution Packaging & Maturity:
rbwis packaged in official repositories across Arch, Debian, Fedora, Alpine, NixOS, and macOS Homebrew for one-command installation.omawardenis primarily distributed via AUR and GitHub Releases, and is not yet in other official distribution repositories. - Headless & Server Compatibility:
rbwpaired withpinentry-cursesworks seamlessly in pure TTYs, servers, or minimal Docker containers without Secret Service daemons.omawardenrelies on system Secret Service keyrings for secure token persistence. - Interactive CLI Editing:
rbwprovidesrbw editto open$EDITORand modify vault items directly from the terminal.omawardencurrently focuses on read, extract, copy, and generation workflows, and terminal-based vault item mutation is not yet supported (planned for future releases).
| Shortcut | Description |
|---|---|
| Enter | Copy primary credential (Password / Card Number / Public Key) |
| Ctrl + Enter | Copy live TOTP code |
| Ctrl + U | Copy username |
| Ctrl + T | Toggle field / secret visibility (passwords, keys, card codes, etc.) |
| Ctrl + H | Open password history modal for the selected login item |
| Ctrl + O | Open primary website URL in default browser |
| Ctrl + K | Open Action Palette (Copy username, TOTP, PIN, Org Name, History, etc.) |
| Ctrl + G | Open built-in Password & Passphrase Generator |
| Ctrl + , | Open / Toggle Settings configuration view |
| Ctrl + L | Manually lock the vault immediately |
| Ctrl + R | Trigger manual vault sync with Bitwarden server |
| ↓ / ↑ | Navigate item list or action options (stops at boundaries) |
| Tab | Switch category filters (All, Logins, Cards, Identities, Secure Note, SSH Keys) |
| Alt + V | Switch or cycle Vault / Organization scope filter (All, Personal, Organizations) |
| Alt + F | Switch or cycle Folder scope filter (All Folders, specific folder) |
| Esc | Dismiss Action Palette, History modal, Settings, or hide overlay |
Ensure the following tools are available on your system:
- omawarden Engine: High-performance Rust backend for Bitwarden (distributed via AUR or GitHub Releases)
- Keyring / Secret Service:
secret-tool(libsecretpackage on Arch/Debian/Fedora) - Wayland Clipboard:
wl-clipboard(wl-copy/wl-paste) - Polkit (Optional for Quick Unlock):
polkit/ system authentication daemon for fingerprint or system password quick unlock (org.omarchy.plugin.icyleaf.omarchy-bitwarden.policy)
Tip
One-Click Setup: When opening Omarchy Bitwarden for the first time without prerequisites, an interactive Dependency Check view automatically appears, allowing you to install omawarden-bin, libsecret, and wl-clipboard with a single click via an Omarchy floating terminal popup.
The native engine is officially distributed on AUR in two flavors:
omawarden-bin(Recommended): Official pre-compiled release binary package.omawarden-git: Development VCS package built from the bleeding-edgedevelopbranch.
# Install stable pre-compiled release (recommended)
paru -S omawarden-bin
# or
yay -S omawarden-bin
# Or install bleeding-edge development VCS package
paru -S omawarden-git(Non-Arch distributions can download pre-built binaries directly from GitHub Releases and place them in your $PATH).
omarchy plugin add https://github.com/icyleaf/omarchy-bitwarden.git --enable-- ~/.config/hypr/bindings.lua
-- Option 1: Dedicated hotkey (e.g. SUPER + B)
o.bind("SUPER + B", "Omarchy Bitwarden", "omarchy-shell shell toggle icyleaf.bitwarden")
-- Option 2: Replace Omarchy default password shortcut (1Password)
-- hl.unbind("SUPER + SHIFT + SLASH")
-- o.bind("SUPER + SHIFT + SLASH", "Omarchy Bitwarden", "omarchy-shell shell toggle icyleaf.bitwarden")
o.window({ class = "org.quickshell", title = "^Bitwarden$" }, {
float = true,
center = true,
size = { 1152, 768 }
})Omarchy Bitwarden seamlessly identifies and manages the active engine source in the Settings modal:
[ AUR: omawarden-bin ]/[ AUR: omawarden-git ]: Active when installed via pacman/AUR. Offers channel-aware one-click update actions (Update (AUR)) that launch your terminal AUR helper (paruoryay).[ System ]: Active on non-Arch distributions when running a standalone pre-compiled binary located in your system$PATH(e.g./usr/local/bin/omawarden).- Development Suppression: Development builds (e.g.
0.8.0-devor VCS revisions fromomawarden-git) automatically suppress standard release update notifications to prevent downgrade prompts.
- Update Plugin:
omarchy plugin update icyleaf.bitwarden- Uninstall Plugin:
killall omawarden
omarchy plugin remove icyleaf.bitwardenomarchy-bitwarden supports two authentication methods for connecting to Bitwarden or self-hosted Vaultwarden instances:
- Default & Direct: Enter your account email and Master Password directly in the overlay login form.
- Comprehensive Two-Factor Authentication (2FA):
- Authenticator App (TOTP) (Provider 0): Enter your 6-digit verification code from your authenticator app.
- Email Verification Code (Provider 1): Automatically dispatches an email challenge code with resend capabilities.
- Hardware Security Key / WebAuthn / FIDO2 (Provider 7): Native hardware security key support (YubiKey, SoloKey, Nitrokey, passkeys). Visual prompt instructs you to touch the physical security key, with support for user presence, user verification, and optional PIN entry.
- Multi-Provider Switcher: When multiple 2FA methods are active on your account (e.g. Security Key + Authenticator + Email), an interactive provider selector allows switching between methods on the fly, with smart default selection favoring hardware security keys.
- New Device Verification: Seamlessly detects and prompts for email OTP verification challenges when logging in from a newly recognized device.
- Remember Email: Optionally toggle "Remember Email" to prefill your login email address across sessions.
- Official Bitwarden CLI Standard: Recommended for headless environments or accounts with hardware key / Duo 2FA.
- How to obtain:
- Open the Bitwarden Web Vault (or your self-hosted Vaultwarden instance).
- Navigate to Settings → Security → Keys tab.
- Click View API Key and enter your master password.
- Copy your
client_id(e.g.user.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) andclient_secret.
- In Omarchy Overlay: Switch the login tab to API Key, paste your
client_idandclient_secret, and log in. Once authenticated, subsequent unlocks are completed via your Master Password. - Keyring Persistence & Silent Renewal: Your
client_secretis securely preserved in the system Keyring (never written to disk). When 2-hour access tokens expire,omawardenautomatically and silently re-authenticates in the background without interrupting sync or kicking you back to re-login.
For self-hosted Vaultwarden or Bitwarden deployments protected behind reverse proxies with client certificate verification (mTLS, e.g., Cloudflare Access, NGINX, or Traefik):
- Supported Formats:
- PKCS#12 bundle (
.p12/.pfx) - PEM encoded client certificate (
.crt/.pem) with separate private key (.key)
- PKCS#12 bundle (
- Keyring Passphrase Protection: Passphrases for encrypted certificate files are stored in the system Keyring rather than in plaintext config.
- CLI Configuration:
# Configure PKCS#12 bundle with passphrase from stdin echo "cert_passphrase" | omawarden config set \ --client-cert ~/.config/certs/client.p12 \ --client-cert-password-stdin # Configure PEM certificate with separate private key omawarden config set \ --client-cert ~/.config/certs/client.crt \ --client-key ~/.config/certs/client.key
omarchy-bitwarden is engineered with a strict zero-trust, descriptor-isolated security model to protect your credentials from process snooping, memory dumps, and environment leakage on Linux:
flowchart TD
subgraph Frontend["QML Overlay (Omarchy Shell)"]
UI_Pwd["Master Password"]
UI_2FA["2FA Code"]
UI_API["API Client Secret"]
UI_TOTP["TOTP Seed"]
UI_Clip["Clipboard Text"]
end
subgraph Seam["Protected Input Seam"]
P_Stdin["Protected Stdin Pipe (/proc/self/fd/0)\nZero-Argv • Immediate Memory Flush"]
P_Sock["0600 Unix Domain Socket (/run/user/UID/omawarden.sock)\nPeer UID Verification"]
end
subgraph Engine["Pure Rust Engine (omawarden)"]
direction TB
Daemon["Resident In-Memory Daemon\nZeroized Memory on Drop (zeroize)"]
Crypto["Native Cryptography Engine\nPBKDF2 • Argon2id • AES-256-CBC • RSA-OAEP-SHA1"]
REST["Direct Bitwarden REST/OAuth2 Client\nSilent Background Re-authentication"]
Clipboard["Ephemeral Wayland Clipboard (wl-copy)"]
end
subgraph SecurityStore["Protected System & Disk Stores"]
Keyring["System Keyring (Secret Service)\nAccess/Refresh Tokens • API Secrets • Session\nZero Plaintext on Disk"]
Disk["Local Cache File (0600)\nZero-Knowledge Ciphertext Only\nCiphers • Folders • No Bearer Tokens"]
end
UI_Pwd -->|Protected Stdin| P_Stdin
UI_2FA -->|Protected Stdin| P_Stdin
UI_API -->|Protected Stdin| P_Stdin
UI_TOTP -->|Protected Stdin| P_Stdin
UI_Clip -->|Protected Stdin| P_Stdin
P_Stdin --> Engine
P_Sock <-->|IPC Queries| Daemon
Daemon <--> Crypto
Daemon <--> REST
Daemon --> Clipboard
REST <-->|Silent Re-auth / Fetch Tokens| Keyring
Daemon <-->|Read / Write E2E Ciphertext| Disk
Daemon <-->|Session & Credentials| Keyring
- Zero Command-Line (
argv) Credential Leakage: Master passwords, client secrets, 2FA codes, TOTP seeds, and clipboard text are never passed as command-line arguments. By delivering all sensitive data exclusively through protectedstdinstreams or0600Unix domain sockets, command line inspection reveals zero sensitive credentials. - Zero Process Environment (
env) Secret Spillage: API client secrets, passwords, and live session tokens are never exported to process environment variables (/proc/<pid>/environ). - Strict Owner-Only File & Socket Permissions (
0600) & Peer UID Verification: The local vault cache file, downloaded attachments, and daemon Unix socket (/run/user/<UID>/omawarden.sock) enforce strict0600permissions and kernel-level peer UID verification (SO_PEERCRED), isolating endpoints across user accounts. Note: processes running under the same OS user account share UID privileges; process-level sandboxing (e.g. Bubblewrap/Flatpak) is recommended for isolating local untrusted applications. - Deterministic Master Key Zeroization (
zeroize): All cryptographic keys (SymmetricCryptoKey), derived master keys, and intermediate crypto buffers implementzeroize::ZeroizeOnDropto overwrite key memory with zeros upon drop. When the vault is locked, all decrypted vault records in daemon memory are immediately cleared and dropped. - Native FreeDesktop Secret Service Keyring Lifecycle: Bearer tokens (
access_token,refresh_token), API key secrets (client_secret), and active session tokens are stored securely inside the system Keyring (GNOME Keyring / KWallet / KeePassXC) via D-Bus Secret Service protocols. The local cache file is a pure zero-knowledge ciphertext store with zero plaintext bearer tokens or master passwords on disk. Immediate session destruction occurs on lock (Ctrl+L), screen-lock events (hyprlock/swaylock), or idle timeout. - Ephemeral Clipboard Auto-Clearing (30s TTL): When copying passwords, TOTP codes, card CVVs, or SSH private keys, sensitive values are piped directly to
wl-copywithout entering shell logs. A dedicated timer daemon automatically clears the Wayland clipboard after 30 seconds (configurable in Settings). - Zero External Runtime Dependencies: 100% pure Rust binary. No external Node.js, Python, or official
bwCLI binary is required at runtime.
omawarden includes a native OpenSSH agent implementation that serves SSH keys directly from your encrypted vault over the standard OpenSSH agent protocol.
- Zero Disk Keys: Private keys stay encrypted in the vault and are parsed in memory strictly for the duration of a single signature, zeroized immediately afterwards.
- Unlock on Demand: When an SSH or Git client requests a key while the vault is locked, the daemon automatically summons the Omarchy overlay to prompt for your master password (waiting up to 60s).
- Interactive Approval Prompts:
first-use(default): Asks once per key, client binary, and launching application (e.g. your terminal or editor); remembered until logout.always: Confirms every individual signature request.never: Signs silently as long as the vault is unlocked.
- Agent Forwarding Defense: Forwarded requests (
session-bind@openssh.com) are cryptographically verified and always prompt for approval, preventing compromised remote servers from silently using your keys. - Anti-Misclick Guard: The approval card in Omarchy Shell ignores Enter and Allow for its first 600ms, preventing accidental approvals from stray keystrokes while typing in other windows.
- Fallback Notifications: When the shell overlay is unavailable, falls back to desktop notifications with Approve/Deny buttons.
- No Idle Keep-Alive Leakage: Listing keys (
ssh-add -l) never refreshes the vault idle timer.
- Enable in Settings:
- Toggle SSH Agent in Settings (Ctrl+,), or run:
omawarden config set --ssh-agent true --ssh-agent-confirm first-use
- Toggle SSH Agent in Settings (Ctrl+,), or run:
- Export Environment Variable:
Point
SSH_AUTH_SOCKto the daemon's agent socket in~/.bashrc,~/.zshrc, or~/.config/uwsm/env:Or specify it inexport SSH_AUTH_SOCK="$XDG_RUNTIME_DIR/omawarden-ssh-agent.sock"
~/.ssh/config:Host * IdentityAgent ~/.config/omawarden/ssh-agent.sock # or $XDG_RUNTIME_DIR/omawarden-ssh-agent.sock
- Inspect & Manage via CLI:
# Check agent running status and socket location omawarden ssh-agent status # List pending signatures waiting for approval omawarden ssh-agent pending # Answer a prompt from the terminal omawarden ssh-agent reply <id> --allow omawarden ssh-agent reply <id> --deny
Generate cryptographically secure passwords or EFF Diceware passphrases directly in the overlay (Ctrl+G) or via the CLI.
- Character Passwords: Configurable length (5–128), uppercase, lowercase, numbers, special symbols, minimum digit/symbol counts, and visual ambiguity filtering (
0,O,1,l,I). - Diceware Passphrases: Word-based passphrases with configurable word count (3–20), custom separators (e.g.,
-,_,.), and word capitalization. - Instant Entropy Rating: Real-time visual entropy score in bits (Weak, Fair, Good, Strong) in the overlay modal.
- Clipboard Guard: Direct copy to Wayland clipboard with automatic 30s auto-clearing TTL.
# Generate a 24-character password and copy to clipboard
omawarden generate -l 24 -c
# Generate password avoiding ambiguous characters (0, O, 1, l)
omawarden generate -l 18 --avoid-ambiguous
# Generate a 5-word Diceware passphrase separated by dots
omawarden generate --passphrase -w 5 -s . --capitalize -c- In-memory caching & sub-millisecond fuzzy search
- Full Argon2id / PBKDF2 / AES-256-CBC / RSA-OAEP native decryption
- Real-time live RFC 6238 TOTP token engine & visual countdown
- Screen-lock auto-lock hook & FreeDesktop Secret Service Keyring integration
- Multi-slot system Keyring credential persistence & silent background re-authentication
- Ephemeral Wayland clipboard manager with 30s auto-clear TTL
- Encrypted binary attachment downloads & inline previews (images & text)
- SSH key management (Ed25519/RSA/ECDSA generation, file import & export)
- Vault-backed OpenSSH agent with unlock-on-demand and approval prompts
- Multi-dimensional vault (personal/organization) and folder scope filtering
- Multi-organization & collection key unwrapping with badges
- Action Palette (Ctrl+K) & password history viewer (Ctrl+H)
- FIDO2 / WebAuthn passkey indicator & item creation/update history
- Locked-state background sync (syncing encrypted ciphertext while vault is locked)
- Self-hosted Vaultwarden & personal API key login support
- Comprehensive 2FA support (Authenticator TOTP, Email verification, and native FIDO2 / WebAuthn hardware security keys)
- Official Arch Linux AUR distribution (
omawarden-bin,omawarden-git) with UI engine source badges - Channel-aware update management & floating terminal dependency installer
- Persistent search state (remembers query, category, and selected item across window sessions)
- Dual-channel structured logging & privacy-redacted diagnostics
- Cryptographically secure random password generation (length, charset options, ambiguity filters)
- EFF Diceware passphrase generation with configurable word count and separators
- Native
omawarden generateCLI command with Clipboard Guard auto-clearing (-c / --copy) - Daemon IPC generation endpoint and structured response model
- Overlay
PasswordGeneratorModal.qmlwith interactive length/entropy controls and regeneration - Action Palette (Ctrl+K) global generator shortcuts
- Implement OpenSSH Agent protocol Unix domain socket (
SSH_AUTH_SOCK) - In-memory private key signing without writing decrypted keys to disk
- Unlock-on-demand and lock-state awareness (opens overlay or suspends when vault is locked)
- Interactive approval card with 600ms anti-misclick guard & notify-send fallback
- Scoped
first-useauthorization (key, binary, ancestor app) & agent forwarding defense - CLI commands (
omawarden ssh-agent status|pending|reply)
- Polkit-backed quick unlock (ADR 0025): after a soft lock, unlocking asks for the login password or fingerprint instead of the master password
- User key retained in mlocked, non-dumpable daemon memory across soft locks; never written to disk or the keyring
- Hard locks wipe the retained key: suspend, maximum session lifetime, explicit lock/logout, daemon exit, three denied prompts, server/account change
- SSH agent: a locked key request triggers the system authentication prompt natively
- Opt-in
quick_unlocksetting (omawarden config set --quick-unlock true|false) with an overlay toggle and honest trade-off disclosure - Packaged polkit policy (
/usr/share/polkit-1/actions/org.omarchy.plugin.icyleaf.omarchy-bitwarden.policy); master password always remains as fallback. Manual/dev installs: copy that file to the same directory yourself, and remove the pre-renameorg.omarchy.bitwarden.policyif it is still there (packaged upgrades do both viapackaging/omawarden-policy.install); a daemon restart picks the new action id up.
- New item creation modal in Overlay (Login, Secure Note, Card, Identity)
- Client-side cipher payload encryption (AES-256-CBC / HMAC) using user master key
- Bitwarden REST API POST
/cipherscreation integration with auto-session renewal - Local zero-knowledge ciphertext cache synchronization upon creation
- Integration with Phase 2 password generator for inline credential creation
- In-place item editing (updating login credentials, cards, notes, custom fields)
- Folder and organization collection reassignment
- Secure item deletion & soft-delete (Recycle Bin) management
- Client-side cipher update validation and server sync reconciliation
- Wayland auto-type / auto-fill integration (e.g. via
ydotool/wtype) - Quick biometric / PAM / Fingerprint system unlock (ADR 0025) — shipped in Phase 3.5 via polkit
We welcome contributions of all kinds! To ensure smooth collaboration and automated changelog generation, please follow our development workflow:
- Branch off
develop: Themainbranch is reserved for tagged releases. All active development (features, bug fixes, refactors) branches offdevelop:git checkout develop && git pull git checkout -b <type>/<short-description> # Types: feat/, fix/, chore/, refactor/, sec/
- Local Verification: Ensure formatting, lints, and tests pass before committing:
(Optional) If you use
cd omawarden cargo fmt --check cargo clippy --all-targets --all-features -- -D warnings XDG_RUNTIME_DIR=/tmp cargo test
mise, you can runmise run buildormise run dev-deploy-fullfor local testing. - Conventional Commits: Write clear commit messages following Conventional Commits (e.g.,
feat(daemon): ...,fix(ui): ...). - Submit PR against
develop: Open your Pull Request targeting thedevelopbranch.
For complete development details, please see CONTRIBUTING.md.
omarchy-bitwarden is built upon the great foundation and inspirations of the open-source community:
- Bitwarden CLI (
bw): Gratitude to the official Bitwarden team for their protocol specifications, API designs, and comprehensive reference client. - rbw: Tremendous appreciation to
rbwfor pioneering a lightning-fast, zero-knowledge resident Rust daemon architecture, which served as a major inspiration foromawarden.
This project is open-sourced under the MIT License.
