diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a610d50
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# hydra-rce
+
+Send code to Hydra from Neovim
+
+## Usage
+
+* Add contents of `keymap.lua` to your Neovim config
+* Install dependencies
+    * Server: `aiohttp`, `websockets`
+    * Hydra: simply run `npm install`
+* Run server (`scripts/server.py`) and Hydra (`npm run dev`)
+* Try running the following snippet by selecting it in visual mode and pressing Alt+Enter:
+
+```javascript
+solid([1, 0, 0], [0, 1, 0], [0, 0, 1]).out();
+```