diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b50bead
--- /dev/null
+++ b/README.md
@@ -0,0 +1,4 @@
+# circuit-notation
+
+This is a plugin for manipulating circuits in clash with arrow notation. See example/Example.hs for
+example usage. Also see [clash-protocols](https://github.com/clash-lang/clash-protocols#).