diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..b73201b
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,9 @@
+# Taskwarrior Lua
+
+A simple lua helper to import and export task data to and from taskwarrior using
+its builtin `import` and `export` commands.
+
+The `import` function imports data into Lua using `task export` and vice versa.
+
+The `import` function takes an optional list of filters to pass on to task
+warrior to limit which tasks are to be updated.