diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1e1054b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+tilde.town blogging platform
+============================
+
+a command-line based blogging platform running on tilde.town
+
+to use, run `~endorphant/bin/ttbp` while logged in to tilde.town