Skip to content

🔒 A simple, secure and personal password manager

License

Notifications You must be signed in to change notification settings

kelvins/passager

Repository files navigation

🔒 Passager

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.

📦 Installation

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

🚸 Usage

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

🛠️ Settings

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.

👷 Development

Build the project using:

$ make build-dev

Run all tests and calculate the code coverage using:

$ make tests