diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c441550
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# progress — Demo tool for the libscterm library
+
+Simple tool, meant to be built and run (not installed).
+
+## Build
+
+`make`
+
+after installing dependencies:
+
+- [libscterm](https://git.bobpolis.com/bob/libscterm/)
+- [libscgui](https://git.bobpolis.com/bob/libscgui/) NOT YET AVAILABLE
+
+## Run
+
+`./progress`
+