Documentation
README
CAO Plugin Creator
Guide for creating a new CAO plugin. A "plugin" is a Python package installed alongside CAO that subscribes to CAO lifecycle and messaging events via typed async hooks.
What You're Building
A CAO plugin is a standalone Python package that:
- Subclasses
CaoPluginfromcli_agent_orchestrator.plugins - Registers async hook methods with
@hook("<event_type>")decorators - Is discovered via the
cao.pluginsPython entry-point group atcao-serverstartup - Runs fire-and-forget — plugin exceptions are caught and logged as warnings, never propagated back into CAO
Typical uses: forwarding inter-agent messages to chat apps, logging/observability, external dashboards, metrics export, alerting on session or terminal lifecycle.
This is the opening of the README. Read the full README on GitHub.