diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ee33ed6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+twtxtlist
+=========
+
+this is an openly available list of users of 
+[twtxt](https://github.com/buckket/twtxt), the decentralized microblogging 
+tool. this will poll every submitted user every 5 minutes to update its views 
+and timelines.