diff --git a/README.md b/README.md
index eee051b..831cdd7 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,21 @@
 # `tilde` - user script tilde-launcher
 
 ```
-wrapper for user-submitted scripts
-supports user submission and admin approval
+Usage: tilde [options] [command]
 
-usage: tilde [help|list|submit|about|<script_name>]
+Options:
+  -h, --help         Show this help message and exit
+  -v, --version      Show version information
 
-  tilde list                 - show a list of approved userscripts
-  tilde submit               - start the submission flow for your own script
-  tilde about <script_name>  - get the description for script_name
-  tilde <script_name>        - run script_name with all remaining args are passed to the script
+Commands:
+  list               Show a list of approved user scripts
+  submit             Start the submission flow for your own script
+  about <script>     Show description and details of a specific script
+  approve            Enter the approval queue for pending scripts (requires root)
+  revoke <script>    Revoke a previously approved script (requires root)
+  run <script>       Run an approved script
+
+Please add /tilde/bin to your PATH to use approved scripts without this wrapper.
 ```
 
 approved scripts are placed in /tilde/bin and listed with `tilde list`