diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d6e74da
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# agedit
+
+open an age encrypted file in $EDITOR
+
+## cli
+`go install git.burning.moe/celediel/agedit@latest`
+
+`agedit [flags] filename`
+
+### flags
+
+```   --identity value, -i value  age identity file to use
+   --out value, -o value       Write to this file instead of the input file
+   --log value, -l value       log level (default: "warn")
+   --help, -h                  show help
+   --version, -v               print the version
+```
+
+## library
+`go get git.burning.moe/celediel/agedit@latest`
+
+See `./cmd/agedit/agedit.go` for example usage.