Plugin SDK
Plugin Architecture
How the plugin system works under the hood.
Overview
The Plugin SDK lets you extend AgentAGI with custom capabilities. The system consists of a Plugin Manager (340 lines), Plugin Loader, and runtime sandbox that handles installation, dependency resolution, and secure execution.
Plugin Lifecycle
- Install — Plugin is uploaded and validated against the manifest schema
- Load — Plugin loader reads capabilities and registers them with the system
- Activate — Plugin becomes available for agent discovery and use
- Execute — Agents discover plugin tools via capability registry and invoke them
- Deactivate/Uninstall — Plugin is removed safely without affecting running tasks
Security Model
Plugins run in a sandboxed environment with explicit permissions. The manifest declares required permissions, and the system enforces them at runtime.
See the Plugin Quick Start to build your first plugin.