diff --git a/README.md b/README.md
index 653603b..6db03ac 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,12 @@
 # winscrape
 
-driver scraper for windows update catalog written in java :thumbsdown:
\ No newline at end of file
+driver scraper for windows update catalog written in java :thumbsdown:
+
+# how to use
+
+Ensure that `agent-jones.exe` and `agent-smith.jar` are inside of the same working directory. Then execute `agent-smith.jar` with two parameters.
+The first parameter must be the search key in quotes like so: `"bios driver"`, and the second parameter must be a list of imports seperated by a comma.
+
+```
+java -jar agent-smith.jar "bios driver" "MmMapIoSpace,MmMapIoSpaceEx,ZwMapViewOfSection"
+```
\ No newline at end of file