diff --git a/csbt.README b/csbt.README
new file mode 100644
index 000000000..225c1ed5b
--- /dev/null
+++ b/csbt.README
@@ -0,0 +1,7 @@
+`csbt` is a coursier-based sbt launcher.
+
+It is extremely experimental, suffering a few issues. In particular, compiling
+several modules at once (e.g. by running `csbt test:compile` from the coursier
+sources) often results in spurious scalac errors. Also, it might have issues
+with `*.sbt` files under `~/.sbt` - the whole point of csbt would be to scrap
+those for standard configuration files.