1 files changed, 20 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b075e3f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# aerc
+
+aerc is a *work in progress* email client for your terminal.
+
+It is not yet suitable for daily use.
+
+## Building
+
+    go build
+
+## Usage
+
+Start by copying the example configs, `config/aerc.conf` and
+`config/accounts.conf` and editing them to taste, to `~/.config`. Then run
+`./aerc2`.
+
+## Contributing
+
+Send patches to
+[~sircmpwn/public-inbox@lists.sr.ht](mailto:~sircmpwn/public-inbox@lists.sr.ht).