A lightweight macOS menu bar app that replaces 1Password's Quick Access popup. Uses the op CLI to search and retrieve credentials, rendered in a floating panel that tiling window managers ignore.
1Password's native Quick Access creates a standard macOS window that tiling window managers (like AeroSpace) try to manage, causing workspace switching, popup disappearing, and focus issues. Alfred and Raycast integrations exist but have limitations (non-customizable shortcuts, automation bugs).
OnePass Quick uses an NSPanel at a floating window level that tiling WMs ignore -- the same technique Alfred and Raycast use for their own popups.
- Floating panel compatible with AeroSpace and other tiling WMs
- Fuzzy search across all 1Password items
- Keyboard-first workflow with customizable selection styles
- Concealed clipboard with automatic 30-second clear
- Global hotkey (Cmd+\) with non-US keyboard layout support
- Deep linking into the 1Password desktop app
| Shortcut | Action |
|---|---|
Cmd+\ |
Show/hide panel (global) |
Up/Down |
Navigate results |
Enter |
Open URL in browser |
Cmd+C |
Copy primary field (username, card number, etc.) |
Cmd+Shift+C |
Copy secret field (password, CVV, etc.) |
Cmd+Option+C |
Copy tertiary field (OTP, expiry, etc.) |
Cmd+O |
Open in 1Password |
Esc |
Dismiss panel |
- macOS 14 (Sonoma) or later
- 1Password desktop app with "Connect with 1Password CLI" enabled (Settings > Developer)
- 1Password CLI:
brew install 1password-cli
brew install xcodegen fastlane
git clone https://github.com/awernick/onepass-quick.git
cd onepass-quick
fastlane mac installThis builds the app, installs it to /Applications, and launches it. Grant Accessibility permission when prompted (required for the global hotkey).
On first launch, macOS will prompt for:
- Accessibility -- required for the global Cmd+\ hotkey (CGEvent tap)
Grant access in System Settings > Privacy & Security > Accessibility.
- UI: SwiftUI views embedded in an AppKit
NSPanel(floating window level) - Backend:
opCLI for all 1Password data access (no direct vault access) - Hotkey: CGEvent tap for global Cmd+\ with
UCKeyTranslatefor keyboard layout support - Dependencies: None -- system frameworks only
Cmd+\ pressed
-> Toggle NSPanel visibility
-> Load cached item list, focus search field
-> User types -> fuzzy filter client-side (debounced, background thread)
-> User selects item + action shortcut
-> Fetch credentials via op CLI (on demand, not pre-fetched)
-> Copy to clipboard (concealed, auto-clear 30s)
-> Dismiss panel, restore focus to previous app
See CONTRIBUTING.md for development setup, code style, and commit conventions.