Skip to content

Repository files navigation

NativePass

NativePass

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 MIT License macOS pass compatible

Documentation · Install · Issues · Build


Main window

Features

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

Install

brew tap li-nd/apps
brew trust li-nd/apps
brew install --cask nativepass

Tap: 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.

Requirements

brew install pass gnupg gnu-getopt pinentry-mac pass-otp
pass init YOUR_GPG_KEY_ID

Configure pinentry-mac so GPG can show a passphrase dialog (Touch ID friendly):

# ~/.gnupg/gpg-agent.conf  (Apple Silicon)
pinentry-program /opt/homebrew/bin/pinentry-mac
gpgconf --kill gpg-agent

Full steps: Setup guide.

Screenshots

Entry with TOTP   New entry

Nested folders   Security settings

Build

  1. Open NativePass.xcodeproj in Xcode.
  2. Select the NativePass scheme and run (⌘R).

Requires a working pass store on the machine (see above).

Documentation

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

Preview docs locally

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-docs.txt
mkdocs serve

Pages deploy automatically from main via .github/workflows/docs.yml.

License

MIT © Markus Lind

About

Native macOS client for the Unix password manager pass

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages