diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d234e2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# mini.diff.jj
+
+[mini.diff](https://github.com/nvim-mini/mini.nvim) source for [jj](https://github.com/jj-vcs/jj).
+Pretty much based entirely on [@farnoy's](https://github.com/farnoy) implementation in [this discussion](https://github.com/nvim-mini/mini.nvim/discussions/1783).
+
+## Installation
+
+```lua
+vim.pack.add({
+  "https://tangled.org/ronshavit.com/mini.diff.jj",
+})
+```
+
+## Usage
+
+```lua
+require("mini.diff").setup({
+  sources = {
+    require("mini.diff.jj"),
+    -- ... other sources
+  },
+})
+```