diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3bd555f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# libcoio
+a clean, minimal, portable coroutine library
+
+## Compiling
+Just run 'make' in the project dir
+
+## License
+ISC License except where otherwise noted.
+
+BSD-Style/GPL for coro.c/.h