Plugins

Plugins extend botster with custom behavior. They're Lua scripts loaded at hub startup.

Plugin location

Place plugins in the plugins/ directory at any config layer:

~/.botster/shared/plugins/my-plugin/init.lua        # All profiles
~/.botster/profiles/standard/plugins/my-plugin/     # Specific profile
your-repo/.botster/shared/plugins/my-plugin/        # Repo-wide
your-repo/.botster/profiles/web/plugins/my-plugin/  # Repo + profile

Plugin structure

Each plugin is a directory with an init.lua entry point:

plugins/
  my-plugin/
    init.lua    # Entry point, loaded at startup

Load order

Plugins are loaded in alphabetical order within each config layer. The 4-layer merge applies: device shared first, then device profile, repo shared, and repo profile last. Plugins support hot reload — changes take effect without restarting the hub.