diff --git a/README.md b/README.md
new file mode 100644
index 0000000..55dbc8c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# mandelbrot
+requires [chez scheme](https://cisco.github.io/ChezScheme/)
+## usage
+```sh
+scheme --script mandelbrot.ss PATH WIDTH HEIGHT [color:hex*]
+```
+example, alternating between red, green, and blue:
+```sh
+scheme --script mandelbrot.ss /tmp/rgbdelbrot.ppm 500 300 dd1111 11dd11 1111dd
+```
+(many things should be customizable but aren't.
+the aspect ratio is 5/3)