Plugins exposed via d-bus remote.

README.md

@@ -45,6 +45,49 @@ toolkit, OpenOffice/LibreOffice, Gecko, WebKitGtk, and KDE Qt toolkit.
 - **External integration**: Other applications can speak through Cthulhu
 - **Simple protocol**: `echo "text" | socat - UNIX-CLIENT:/tmp/cthulhu.sock`
 
+## D-Bus Remote Controller
+
+Cthulhu exposes a D-Bus service for external automation and integrations.
+
+### Service Details
+- **Service Name**: `org.stormux.Cthulhu.Service`
+- **Main Object Path**: `/org/stormux/Cthulhu/Service`
+- **Module Object Paths**: `/org/stormux/Cthulhu/Service/<ModuleName>`
+
+### Discovering Capabilities
+
+```bash
+# List registered modules
+gdbus call --session --dest org.stormux.Cthulhu.Service \
+  --object-path /org/stormux/Cthulhu/Service \
+  --method org.stormux.Cthulhu.Service.ListModules
+
+# List commands on a module
+gdbus call --session --dest org.stormux.Cthulhu.Service \
+  --object-path /org/stormux/Cthulhu/Service/ModuleName \
+  --method org.stormux.Cthulhu.Module.ListCommands
+```
+
+### Plugin Modules
+
+Plugins that expose D-Bus decorators are automatically registered as modules using the naming
+convention `Plugin_<ModuleName>` (for example, `Plugin_GameMode`, `Plugin_WindowTitleReader`).
+
+### PluginSystemManager Module
+
+The `PluginSystemManager` module provides **session-only** plugin control (no preference changes):
+
+- `ListPlugins`
+- `ListActivePlugins`
+- `IsPluginActive` (parameterized)
+- `SetPluginActive` (parameterized)
+- `RescanPlugins`
+
+### More Documentation
+
+See `README-REMOTE-CONTROLLER.md` and `REMOTE-CONTROLLER-COMMANDS.md` for the full D-Bus API
+and usage examples.
+
 ## Dependencies
 
 ### Core Requirements