From 3646d92a5a1d8b4ac42eb0e94bd7d49e32657a0c Mon Sep 17 00:00:00 2001
From: Keith Patrick <keithy@consultant.com>
Date: Thu, 5 Mar 2026 05:18:02 +0000
Subject: [PATCH] docs: add simple plugin example to README

---
 README.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a1931e4ff..07cfbf2a6 100644
--- a/README.md
+++ b/README.md
@@ -1311,7 +1311,14 @@ picoclaw service --help
 picoclaw launcher
 ```
 
-Plugins are executables in `~/.picoclaw/plugins/`. If a plugin is named `picoclaw-service`, you can run it as `picoclaw service` (prefix match).
+Create a plugin:
+
+```bash
+# ~/.picoclaw/plugins/picoclaw-hello
+#!/bin/bash
+echo "Hello from plugin!"
+echo "Args: $@"
+```
 
 For programmatic use, hide the banner: