From 210c0249faa1e50cee2365d4863e6cb82e06f234 Mon Sep 17 00:00:00 2001
From: Chris Wanstrath <2+defunkt@users.noreply.github.com>
Date: Mon, 6 Oct 2025 15:55:02 -0700
Subject: [PATCH] use it

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

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)