Skip to content

[plugins] Reference

Field reference for the [plugins] section. For how to use it, see the Plugins configuration guide.

Fields

Field Type Description Default
enabled list[string] List of enabled plugin names (or regex patterns) []
extra_plugin_dirs list[string] Additional directories to search for plugins []
params dict[string, dict] Per-plugin constructor kwargs, keyed by plugin name. Set as [plugins.params.<plugin_name>] in TOML. {}

Default Plugin Discovery Paths

No extra config is required; these directories are always searched:

Path Contents
src/opensage/plugins/default/adk_plugins/ Built-in ADK plugins
src/opensage/plugins/default/claude_code_hooks/ Built-in Claude hook plugins
~/.local/opensage/plugins/ User-local plugins (.py and .json)

Use extra_plugin_dirs to add more directories.