diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6cb43db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# suwako
+Command-line client for privacy-friendly translation frontends.
+
+## Usage
+-f [lang] (default: auto)
+-i [input]
+-t [lang] (default: en)
+
+## Environment variables
+* SUWAKO_ENGINE
+* SUWAKO_INSTANCE
+
+## Flavors
+* `suwako` works with [SimplyTranslate](https://codeberg.org/ManeraKai/simplytranslate)
+* `suwako-mozhi` works with [mozhi](https://codeberg.org/aryak/mozhi)
+
+Both are functionally the same otherwise.