| 1 | # Extensions |
| 2 | |
| 3 | Extensions are an advanced way to change how Agent Zero behaves. |
| 4 | |
| 5 | If you are new, start with plugins instead. Plugins are easier to create, test, |
| 6 | disable, and remove. |
| 7 | |
| 8 | Architecture details, extension points, and source-linked explanations now live |
| 9 | in [DeepWiki for Agent Zero](https://deepwiki.com/agent0ai/agent-zero). This |
| 10 | local page stays short on purpose. |
| 11 | |
| 12 | ## Start Here |
| 13 | |
| 14 | | Goal | Start here | |
| 15 | | --- | --- | |
| 16 | | Add a small user-facing feature | [Create a Small Plugin](../guides/create-plugin.md) | |
| 17 | | Change agent behavior for a project | [Projects](../guides/projects.md) | |
| 18 | | Create a specialized agent style | [Agent Profiles](../guides/agent-profiles.md) | |
| 19 | | Study extension internals | [DeepWiki](https://deepwiki.com/agent0ai/agent-zero) | |
| 20 | |
| 21 | ## When Extensions Make Sense |
| 22 | |
| 23 | Use an extension only when a normal plugin, project instruction, skill, or agent |
| 24 | profile is not enough. |
| 25 | |
| 26 | Good extension candidates: |
| 27 | |
| 28 | - adding behavior at a specific lifecycle point; |
| 29 | - shaping prompts in a reusable way; |
| 30 | - integrating tightly with core tools; |
| 31 | - preparing framework-owned state before a task starts. |
| 32 | |
| 33 | Avoid extensions for simple UI changes, one-off scripts, or work that should be |
| 34 | easy to remove. A plugin is usually the cleaner home for that. |
| 35 | |
| 36 | ## Maintenance Rule |
| 37 | |
| 38 | Keep extension changes small and easy to explain. If a reader needs the full |
| 39 | architecture to understand why the extension exists, link to the relevant |
| 40 | DeepWiki page instead of copying the architecture into this repository. |
| 41 | |
| 42 | ## Related |
| 43 | |
| 44 | - [Create a Small Plugin](../guides/create-plugin.md) |
| 45 | - [Agent Profiles](../guides/agent-profiles.md) |
| 46 | - [DeepWiki for Agent Zero](https://deepwiki.com/agent0ai/agent-zero) |