aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorBen Burwell <ben@benburwell.com>2018-02-23 23:08:51 -0500
committerBen Burwell <ben@benburwell.com>2018-02-24 00:31:17 -0500
commit335dfdffecf8385044a585ff2b8f1b671e894ae7 (patch)
tree1f84e928e66f1374df34078f094b152e27db4b3f /README.md
parent6ec8b3e334dd35dd8c7a168d3a182a5bd3289c9f (diff)
Update documentationHEADv0.1.0master
Diffstat (limited to 'README.md')
-rw-r--r--README.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e2d4592
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# pass-audit - an extension for the [`pass` password store](https://www.passwordstore.org/)
+
+`pass-audit` helps you check your passwords against known vulnerable ones
+included in the [Have I Been Pwned (HIBP) list of exposed
+passwords](https://haveibeenpwned.com/Passwords).
+
+## Installation
+
+```
+git clone https://github.com/benburwell/pass-audit.git
+cd pass-audit
+sudo make install
+```
+
+**Note:** On macOS, you will need to use `sudo make install PREFIX=/usr/local`
+instead of `sudo make install`.
+
+## Usage
+
+Check all your passwords against the HIBP database:
+
+```
+pass audit all --hibp
+```
+
+For more examples, see `man pass-audit`.
+