A simple, secure and personal password manager.
Some passager
features:
- Easy to use: manage your passwords locally using a simple command line interface (CLI).
- Own your data: move your encrypted database file to wherever you want.
- Secure by default: use advanced encryption standard (AES) by default.
Download the appropriate file for your OS and architecture from the releases page, for example:
$ wget --no-check-certificate https://github.com/kelvins/passager/releases/download/v0.4.0/passager_0.4.0_Darwin_x86_64.tar.gz
Extract the binary:
$ tar -xzvf passager_0.4.0_Darwin_x86_64.tar.gz passager
Make sure the file is executable:
$ chmod +x ./passager
Move the file to a bin directory that is included in your PATH, for example:
$ sudo mv ./passager /usr/local/bin/passager
Check the passager
version:
$ passager --version
Passager v0.4.0
generate
a random and secure password:
$ passager generate
add
a new credential:
$ passager add MyCredential -l [email protected] -p SuperSecret
⚠️ Use a whitespace prefix to your command to prevent it from being included in the history.
get
an existing credential:
$ passager get MyCredential
list
all credentials:
$ passager list
delete
an existing credential:
$ passager delete MyCredential
When in doubt, use the help
flag, for example:
$ passager add -h
It is possible to configure your passager
environment by setting the following environment variables:
PASSAGER_DATABASE
: path to the database file. Default:~/.passager.db
.PASSAGER_ENCRYPTION_KEY
: data encryption key. The encryption key must be 16 bytes.
Build the project using:
$ make build-dev
Run all tests and calculate the code coverage using:
$ make tests