Version: 1.1.0
A password manager using age encryption, compatible with a subset of pass commands. Built for Termux on Android — no GPG agent needed.
Why not the original pass? GPG requires gpg-agent, which relies on Unix sockets and process forking — both problematic under Android's process isolation and proot environment in Termux. age has no agent, no daemons, just file-based key pairs.
git clone https://github.com/josephyoung/age-pass.git cd age-pass ./install.sh # defaults: ~/bin, ~/.age ./install.sh /usr/local/bin # custom bin dir ./install.sh ~/bin /mnt/custom-age # custom age store dir
Requires age and tree. install.sh installs them via pkg if missing (Termux).
pass [show|insert|list|rm|delete|help] [name]
pass insert github/token # silent password input pass show github/token # decrypt and print pass list # tree view pass rm github/token # delete pass delete github/token # alias for rm pass help # show usage
Copy all passwords from your existing GPG-based pass to age-pass:
./pass-migrate --orig-pass /path/to/pass --age-pass /path/to/age-pass
Options:
--orig-pass <path> Path to original pass binary
--age-pass <path> Path to age-pass binary
--dry-run Preview migration, don't write
--force Overwrite existing entries without prompting
The script will:
- Auto-detect both pass binaries (or prompt if not found)
- Read all entries from the original store
- Re-encrypt and save to age-pass
- Verify tree structure and values match
Example:
# Preview what would be migrated ./pass-migrate --orig-pass /opt/homebrew/bin/pass --age-pass ~/bin/pass --dry-run # Run the migration ./pass-migrate --orig-pass /opt/homebrew/bin/pass --age-pass ~/bin/pass # Re-migrate with overwrite ./pass-migrate --force
PASS_AGE_DIR=/custom/path pass list
Or set the default at install time via install.sh second argument.
~/.age/
├── keys.txt # age keypair (chmod 600)
├── install-info.txt # installed path (for migration auto-detect)
└── secrets/ # encrypted password files (.age)
├── email/
│ └── gmail.age
└── github/
└── token.age
bash tests/pass-test.sh # core pass tests bash tests/pass-migrate-test.sh # migration tests
MIT
See CHANGELOG.md for version history.