diff --git a/README.md b/README.md index aea3f55..d0b0527 100644 --- a/README.md +++ b/README.md @@ -1,47 +1,27 @@ -# pass-reveal -An extension for [pass](https://www.passwordstore.org/) (the standard Unix password manager) to easily find elements of the password store. +# pass-append +An extension for [pass](https://www.passwordstore.org/) (the standard Unix password manager) to append a pass-style password and copy it to the clipboard before a `pass insert -m` call. ## Motivation -`pass show` requires that one type in the full path of the service, but I am too lazy to do that. - +`pass generate` is cool. `pass insert -m # <- multiline` is cool. ¿Por qué no los dos? (Why not both?) Well, the answer is that it would be annoying to do in the pass code, I think. ## Usage ``` Usage: - - pass reveal [reveallocation] - On the first run it creates a directory ".reveals" in \$PASSWORD_STORE_DIR. - By default this is ~/.password-store/.reveals". - It creates a reveal of the complete password store by creating a - compressed tar-file with extension .tar.bz2. - reveals themselves are excluded from the reveal. - Without argument the reveal file will receive the default name "passwordstore.DATE.TIME.tar.bz2" - where DATE and TIME are the current date and time. - If an argument is given and it is a directory, the reveal file will be placed - into the specified directory instead of the default ".reveals" directory. - If an argument is given and it is not a directory, it is used as a file - name and the reveal is stored with this filename with .at.gz2 appended. - pass reveal help + pass append [filename] + Generates a strong password, copies it to the clipboard, and runs pass insert -m [filename] + Based on the pass apppend extension, itself based on the pass backup extension. + pass append help Prints this help message. - pass reveal version + pass append version Prints the version number. -Usage: - pass reveal [search-terms] - Searches and displays passwords from \$PASSWORD_STORE_LOCATION. - A simple wrapper over pass show, find, and grep. - Based on the pass reveal extension. - $PROGRAM reveal help - Prints this help message. - $PROGRAM reveal version - Prints the version number. +Example: pass append services/amazon + Generates a strong password, copies it to the clipboard, + and starts pass insert -m services/amazon -Example: $PROGRAM reveal web - Searches for any files in $PASSWORD_STORE_LOCATION whose filenames contain - the keyword "web" ``` @@ -49,45 +29,38 @@ Example: $PROGRAM reveal web Let's generate a password for this example ``` -pass generate test/test +pass append web/digitalocean +Copied new password to clipboard: +Gm,G^98w8e3YZ)Op&pi4v+Q>I +Enter contents of test/test and press Ctrl+D when finished: +Gm,G^98w8e3YZ)Op&pi4v+Q>I +my.email@email-provider.com [master 1dd0d0b] Add generated password for test/test. - 1 file changed, 0 insertions(+), 0 deletions(-) - rewrite test/test.gpg (100%) -The generated password for test/test is: -]$OJ& pass reveal test -Best match: test/test -]$OJ&