Native macOS client for pass
Browse nested folders, copy passwords, show TOTP codes, and sync with Git.
Design inspired by the Passwords app by Apple.
Documentation · Install · Issues · Build
| Browse | Nested folders, search, custom fields · multiple stores |
| Security | GPG-backed store · per-store / folder keys · App Lock (Touch ID) · clipboard auto-clear |
| OTP | TOTP codes via pass-otp |
| Sync | Git Pull / Push · entry History (view / restore) |
| Quick Access | Global hotkey ⌥⌘P — search, copy, or Auto-Type |
Spotlight-style popup from anywhere: fuzzy search your store, then copy or type the password without opening the main window.
Details: Quick Access.
brew tap li-nd/apps
brew trust li-nd/apps
brew install --cask nativepassTap: li-nd/homebrew-apps. Or download a zip from Releases.
Builds are not notarized. If macOS blocks the app: System Settings → Privacy & Security → Open Anyway, or right-click → Open.
brew install pass gnupg gnu-getopt pinentry-mac pass-otpOpen NativePass → Create New Store… (or Choose Existing Folder…). Terminal alternative: pass init YOUR_GPG_KEY_ID.
Configure pinentry-mac so GPG can show a passphrase dialog (Touch ID friendly) — also shown in Settings → Security:
# ~/.gnupg/gpg-agent.conf (Apple Silicon)
pinentry-program /opt/homebrew/bin/pinentry-macgpgconf --kill gpg-agentFull steps: Setup guide.
- Open
NativePass.xcodeprojin Xcode. - Select the NativePass scheme and run (
⌘R).
Requires a working pass store on the machine (see above).
Published site: np.developer.pm
| Page | Topic |
|---|---|
| Requirements | Install app + Homebrew packages |
| Setup | First launch, store, pinentry |
| Password stores | Create, switch, encryption keys |
| Plugins | pass-otp and more |
| Usage | Everyday workflow |
| Troubleshooting | Diagnostics |
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-docs.txt
mkdocs servePages deploy automatically from main via .github/workflows/docs.yml.