diff --git a/README.md b/README.md
index e69de29..ffb3dbd 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,8 @@
+execute lexicon with the arguments u want:
+
+* all
+    - shows all words in heonian
+* search \<query\>
+    - searches all words and shows only those that return to [string.find()](https://www.lua.org/pil/20.1.html)
+* transcript \<word\>
+    - transcripts the word to [heonian script](https://cronut.cafe/~lustlion/myrheon/test/)
\ No newline at end of file