diff --git a/README.md b/README.md
index 3dedb9d..a5cf579 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,21 @@ It's where Shrimp live.
     bun install
     bun test
 
+## Use it
+
+Execute text bytecode:
+
+    ./bin/reef examples/loop.reef
+
+Validate bytecode:
+
+    ./bin/validate examples/loop.reef
+
+Run the simple debugger to see what the instructions are doing:
+
+    ./bin/debug examples/loop.reef
+    ./bin/debug -h examples/loop.reef
+
 ## Features
 
 - Stack operations (PUSH, POP, DUP)