diff --git a/README.md b/README.md
new file mode 100644
index 0000000..26186ac
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# todo.txt as a Telegram bot
+A bot to hold your todo.txt tasks
+
+## commands
+All commands require a preceding `/`.
+- add - add a task
+- rm - remove a task, requires task id
+- ls - list tasks, use 'f[ilter]:FILTERTEXT' syntax to search
+- do - complete a task, requires task id 
+- undo - undo a task, requires task id
+- marco - responds 'polo', tests the bot it up
+
+If no command is specified, it is assumed to be the add command.
+
+
+## todo
+- exporting all tasks
+- favourite commands
+- reminders for tasks with due dates
+- use a real database instead of json files