commit - 5aee7cf1804d35c279a9dab65ef3dee43a38c6c1
commit + b69e2e9a9f64e69e94602a17c26513bba73cc8d3
blob - 569ca95262537648105186af9db21f841e06ea36
blob + 76b21a9080b485ecb4c9b79f2e089e688ea1caad
--- README.md
+++ README.md
@@ -4,7 +4,19 @@ vmd is an Emacs package to interact with [OpenBSD' vmd
 
 ![vmd buffer with transient open](vmd.png)
 
+In a `*vmd*` buffer (opened with `M-x vmd RET`), the following keys
+are defined:
 
+ - `c`: (console) open a terminal connected to the vm at point
+ - `P`: pause the vm at point
+ - `s`: start the vm at point
+ - `S`: stop the vm at point
+ - `u`: unpause the vm at point
+
+additionally, `x` will bring up a transient popup with the mnemonics
+for the keys.
+
+
 ### Customize the terminal for the console
 
 To use vterm (or any other packages really) to handle a shell for the