diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6b9700e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# git-build.rs
+
+Rust reimplementation of git-build.sh
+
+# Running
+
+Requires the translation files from git-build.sh. TODO: Use a dedicated repository for translations, with a git submodule
+
+```
+LANG=fr LOG=debug I18N=~/git-build.sh/i18n/ cargo run --release
+```
+
+# Status
+
+Experimental, not working (yet)