diff --git a/psgen/README.md b/psgen/README.md
new file mode 100644
index 0000000..e4ccf89
--- /dev/null
+++ b/psgen/README.md
@@ -0,0 +1,23 @@
+# psgen
+## A minimal command-line password generator.
+
+## Usage
+
+./psgen [OPTIONAL PASSWORD LENGTH HERE]
+
+### Examples
+
+```
+./psgen 255
+```
+will output a password with length of 255
+
+```
+./psgen
+```
+will output a password with length of 8
+
+```
+./psgen 10
+```
+will output a password with length of 10