pw-vault
v0.1.0
Published
Cross-platform encrypted password vault CLI with a pw-compatible workflow.
Maintainers
Readme
pw-vault
pw-vault is a cross-platform password vault CLI that keeps the familiar pw workflow while storing secrets in an encrypted file instead of a macOS sparse image.
Install
From a local checkout
npm install
npm linkAfter publishing
npm install -g pw-vaultUsage
pw help
pw gen github.com --username [email protected]
pw copy github.com
pw copy github.com username
pw set github.com
pw ls
pw rm github.com
pw migrate --from /Volumes/Vault
pw vault backup ~/Desktop/vault-backup.enc
pw vault rekeyStorage
The vault is stored in an OS-appropriate application data directory unless you override it with PW_VAULT_DIR.
- macOS:
~/Library/Application Support/pw-vault - Linux:
~/.local/share/pw-vault - Windows:
%APPDATA%\\pw-vault
The encrypted file is named vault.json.enc and backups are written to the backups/ subdirectory.
Environment variables
PW_VAULT_DIR: Override the data directory.PW_MASTER_PASSWORD: Provide the vault password non-interactively.PW_CLIPBOARD_CLEAR_SECONDS: Default clipboard clear timeout in seconds.
Migration
Use pw migrate --from <directory> after mounting or exporting the legacy vault contents as .txt files. Each file should be named after the entry, for example gmail.txt.
The importer accepts either:
passwordor:
username
passwordNotes
Clipboard support uses native tools when available:
- macOS:
pbcopy - Linux:
wl-copy,xclip, orxsel - Windows:
clip
If no clipboard tool is available, the CLI reports a clear error.
