diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8879365
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+Recent versions of NetBeans don’t come with plaform-specific installers,
+so we no longer get a nice double-clickable application for operating
+systems like macOS and Windows.
+
+While you can double-click the `netbeans` script under macOS, this isn’t
+particularly nice, and can be tricky to integrate with quick launchers.
+
+This is an AppleScript application that provides a simple double-clickable
+wrapper around the `netbeans` script. On first run, it asks you to locate
+and open that script. It then remembers this location from then on. To reset
+the path, hold down option/alt when opening the application.