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 |
| Security | GPG-backed store · App Lock (Touch ID) · clipboard auto-clear |
| OTP | TOTP codes via pass-otp |
| Sync | Git Pull / Push from the sidebar |
| Quick Access | Global hotkey ⌥⌘P for fast copy |
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-otp
pass init YOUR_GPG_KEY_IDConfigure pinentry-mac so GPG can show a passphrase dialog (Touch ID friendly):
# ~/.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 | Store init & pinentry |
| 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.





