PasswdVault

PasswdVault is a flexible, quick and secure CLI password manager that lets you save and retrieve your passwords locally

Table of Contents

• Getting Started
  • Installing
    • Installing PasswdVault Command Line Tool Manually
  • How to Use
    • Initialize Tool
    • Save a Password
    • Retrieve a Passwords
    • Delete a password
    • List all your password identifiers
    • Search for a password identifier
    • Generate a password
    • Change configuration file data
• PasswdVault Documentation
  • Commands
• How To Use
• Info
• Contact

Getting started

Installing

First of all you'll need to install Go

Installing PasswdVault Command Line Tool Manually

$ git clone https://github.com/MattRighetti/passwdvault.git
$ cd passwdvault
$ make install

How to use

Initialize tool

To initialize the basic files that passwdvault needs you just need to run

$ passwdvault init

where you would like to initialize your passwdvault database.

This command will create a file named .passwdvaultconfig in your $HOME directory and another folder called .passwdvaultdatabase in your current working directory.

Save a password

When you want to save your first password you just need to run the create command with its flags -i and -p to respectively indicate the password identifier and its password, here's an example:

$ passwdvault create -i githubpass -p secret

Retrieve a passwords

When you need a password that you stored the get command is all you're going to need, i.e. to get back my githubpass saved before I'll just need to run

$ passwdvault get githubpass

Delete a password

What about deleting a password that I don't need anymore? The delete command does just that, to delete my githubpass

$ passwdvault delete githubpass

List all your password identifiers

Let's say that you forgot how a certain identifier was named, the list command will print out all the identifiers that you store in the database

$ passwdvault list

Search for a password identifier

There may be some cases where you have a ton of passwords and you don't want to list all the password identifiers, but you just want to search for some that has a certain sub-string in it.

search is meant just for that, let's say that I have these passwords stored:

• githubpass
• server1pass
• awspass
• vs-code-accountpass
• some-random-pass

if I run

$ passwdvault search aws

it will print out my awspass identifier

Generate a password

I'm not good at choosing secure and strong passwords, this is why I always try to use some password generator that will do it for me, in this case the generate command will do just that. Run

$ passwdvault generate

to get a strong password back

Change configuration file data

Let's say that I moved my database folder from $HOME to $HOME/matt, if you run any command without changing the .passwdvaultconfig file you will get an error that tells you that the database cannot be found. If you want to specify the new path to the database you'll need to edit the database.path attribute in the .passwdvaultconfig file. The config command has been created to ease that process, run

$ passwdvault config database.path $HOME/matt

and the tool will automatically update that value for you.

PasswdVault Documentation

Commands

• init
• create
• get
• delete
• list
• search
• config
• version
• generate

Info

PasswdVault is powered by

• cobra
• viper
• badger
• passwdgen

Contact

• Please use Github issue tracker for filing bugs or feature requests.