feat: scaffold owlry-plugins workspace

README.md

@@ -0,0 +1,57 @@
+# owlry-plugins
+
+Official plugins and script runtimes for [owlry](https://somegit.dev/Owlibou/owlry).
+
+## Plugins
+
+| Plugin | Description |
+|--------|-------------|
+| calculator | Mathematical expression evaluation |
+| bookmarks | Browser bookmark search (Firefox, Chrome) |
+| clipboard | Clipboard history via cliphist |
+| emoji | Emoji picker |
+| filesearch | File search via fd/locate |
+| media | MPRIS media player widget |
+| pomodoro | Pomodoro timer widget |
+| scripts | User script launcher |
+| ssh | SSH host quick-connect |
+| system | Power and session management |
+| systemd | systemd user service control |
+| weather | Weather widget |
+| websearch | Web search with configurable engines |
+
+## Runtimes
+
+| Runtime | Description |
+|---------|-------------|
+| owlry-lua | Lua 5.4 scripting runtime for user plugins |
+| owlry-rune | Rune scripting runtime for user plugins |
+
+## Building
+
+```bash
+just build          # Debug build
+just release        # Release build (optimized)
+just plugin calc    # Build a single plugin
+just check          # cargo check + clippy
+just test           # Run tests
+```
+
+## Installation
+
+```bash
+just install-local  # Install all plugins and runtimes to /usr/lib/owlry/
+```
+
+Plugins are compiled as `.so` files and installed to `/usr/lib/owlry/plugins/`.
+Runtimes are installed to `/usr/lib/owlry/runtimes/`.
+
+## Development
+
+See [docs/PLUGIN_DEVELOPMENT.md](docs/PLUGIN_DEVELOPMENT.md) for plugin authoring guide.
+
+Plugins depend on `owlry-plugin-api` from the core repo for the ABI-stable interface.
+
+## License
+
+GPL-3.0-or-later