diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1616a43
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# curly — Working solution to the Krul puzzle
+
+This tool will run a small compiler which implements the language from the [Krul
+puzzle](https://bobpolis.com/krul/). The sources also contain an older
+implementation, to be found in the interpreter files. This could also be used as
+a drop-in replacement for the compiler, by changing the appropriate line in
+`main.cpp`.
+
+## Building
+
+Build using:
+
+`make`,
+
+but first install the dependencies:
+
+- [libsclogging](https://git.bobpolis.com/bob/libsclogging)
+- [libscterm](https://git.bobpolis.com/bob/libscterm)
+- [libscrequest](https://git.bobpolis.com/bob/libscrequest)
+- libcurl
+
+## Install
+
+`sudo make install`
+
+or, on OpenBSD:
+
+`doas gmake install`
+
+## Run
+
+`curly`
+