diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cbf1ae2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# bwzy - bitwarden ... fuzzy
+
+Why? I live in the terminal and wanted a way to get to passwords there. The `bw` cli is great, but not very user-friendly.
+
+# features
+- copy user/pass/totp
+- cache the items to make it fast
+- cache is not persisted to disk
+
+# feature ideas
+- "archive" feature to filter things
+- add ability to edit an entry
+- add ability to add a new entry