diff --git a/README.md b/README.md
new file mode 100644
index 0000000..71d53f6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# Taskwarrior - jrnl task ingestion 
+
+This little script allows simple interaction between `taskwarrior` and a `jrnl` file.
+It parses the `jrnl` file and logs accomplished tasks in `taskwarrior`.
+
+To accomplish this it borrows a little from the [todotxt](http://todotxt.org/) syntax --- 
+namely the idea of (A) (B) (C) prioritization and `x task done syntax` 
+(i.e. starting a line with `x ` means it represents an accomplished task).
+