diff --git a/modules/ssh/README.md b/modules/ssh/README.md
new file mode 100644
index 0000000..ea176c1
--- /dev/null
+++ b/modules/ssh/README.md
@@ -0,0 +1,9 @@
+SSH
+===
+
+Provides a convenient way to load ssh-agent. This enables one-time login and caching of SSH credentials per session.
+
+.zimrc Configuration
+--------------------
+
+  * `zssh_ids=(id_rsa)` add any identities (from ~/.ssh) to this list to have them loaded and cached on login.