agent-zero/docs/developer/plugins.md
Alessandro 58b161e5d3 docs: make Agent Zero guides more human
Refresh README, quickstart, and the docs index around Browser, Desktop, A0 CLI, projects, memory, skills, profiles, and model presets.

Add optimized scoped screenshots for Web UI, Browser, Desktop, and CLI workflows.

Trim architecture-heavy developer pages toward DeepWiki handoffs so local docs stay focused on practical user guidance.
2026-05-09 00:02:11 +02:00

1.7 KiB

Plugins

Most people should start with the practical guide: Create a Small Plugin.

Plugin architecture and source-linked internals live in DeepWiki for Agent Zero. This page stays intentionally small so the repository does not maintain a second plugin manual.

What To Use

Goal Start here
Build your first plugin Create a Small Plugin
Understand how plugins are loaded DeepWiki
Decide what is safe to publish Sharing and Safety
Contribute a plugin upstream Contributing Guide

Minimum Local Plugin

A local plugin usually lives here:

/a0/usr/plugins/<plugin_name>/
├── plugin.yaml
├── README.md
└── webui/

The smallest useful plugin.yaml looks like this:

name: my_plugin
title: My Plugin
description: A short sentence that explains what it does.
version: 1.0.0

Ask Agent Zero to keep the first version small. A tiny plugin that does one visible thing is easier to test, review, and share.

Sharing A Plugin

Before publishing a plugin:

  • keep it in its own public repository;
  • include a clear README.md;
  • include a LICENSE;
  • avoid secrets, local paths, and machine-specific files;
  • explain what the plugin changes and how to remove it.

For Plugin Index submission, use the current instructions in the agent0ai/a0-plugins repository.