diff --git a/examples/bash/README.md b/examples/bash/README.md
new file mode 100644
index 0000000000..ec7a2dab95
--- /dev/null
+++ b/examples/bash/README.md
@@ -0,0 +1,53 @@
+# Electric Bash Client
+
+A simple bash client for consuming Electric shape logs. This client can connect to any Electric shape URL and stream updates in real-time.
+
+## Requirements
+
+- bash
+- curl
+- jq (for JSON processing)
+
+## Usage
+
+```bash
+./client.bash 'YOUR_SHAPE_URL'
+```
+
+For example:
+```bash
+./client.bash 'http://localhost:3000/v1/shape?table=notes'
+```
+
+## Example Output
+
+When first connecting, you'll see the initial shape data:
+```json
+[
+  {
+    "key": "\"public\".\"notes\"/\"1\"",
+    "value": {
+      "id": "1",
+      "title": "Example Note",
+      "created_at": "2024-12-05 01:43:05.219957+00"
+    },
+    "headers": {
+      "operation": "insert",
+      "relation": [
+        "public",
+        "notes"
+      ]
+    },
+    "offset": "0_0"
+  }
+]
+```
+
+Once caught up, the client switches to live mode and streams updates:
+```
+Found control message
+Control value: up-to-date
+Shape is up to date, switching to live mode
+```
+
+Any changes to the shape will be streamed in real-time.