agent-zero/plugins
Alessandro dbf6849c84
Some checks are pending
Build And Publish Docker Images / plan (push) Waiting to run
Build And Publish Docker Images / build (push) Blocked by required conditions
fix(scheduler): use Scheduled Tasks in modal and navigation
Align the scheduler modal title and sidebar dropdown label with the welcome screen Scheduled Tasks card. Update the scheduler documentation and plugin index to match.

Validation: 97 focused scheduler, timezone, tool contract, and WebUI extension tests passed. Confirmed the live instance serves the updated labels.
2026-11-01 20:13:55 +01:00
..
_a0_acp Add ACP plugin thumbnail 2026-08-21 15:47:22 +02:00
_a0_connector Require remote terminal permission for input_remote 2026-11-01 07:49:29 +01:00
_a2a_chat feat: add missing bundled plugin thumbnails 2026-10-27 18:40:11 +01:00
_agent_editor Speed up agent editor loading with deferred Advanced data 2026-10-28 01:31:12 +01:00
_behavior_adjustment feat: add missing bundled plugin thumbnails 2026-10-27 18:40:11 +01:00
_browser Enforce same-origin isolation for browser DOM helper RPC 2026-11-01 07:41:16 +01:00
_chat_branching Skip markdown-wrapped action bars in branch button injection 2026-09-03 15:08:59 +03:00
_chat_compaction Preserve compacted context in provider history 2026-08-23 14:15:36 +02:00
_chat_naming refactor(plugins): serve the tasks and memory surfaces through plugin extension points 2026-10-21 23:37:31 +03:00
_code_execution Copy full execution commands while keeping compact previews 2026-11-01 07:16:55 +01:00
_commands Extend slash command support to WhatsApp 2026-09-14 14:08:47 +02:00
_context_doctor Keep model prose as thoughts and retry silently 2026-11-01 06:50:49 +01:00
_context_window Speed up chat loading and guard selector refresh races 2026-10-10 14:10:35 +02:00
_desktop fix(docker): load the signed Xpra ARM64 package index 2026-10-13 17:23:11 +02:00
_discovery Remove Connect prefix from welcome channel entries 2026-11-01 01:24:04 +01:00
_document_query feat(document-query): render document_query tool calls through a dedicated badge 2026-10-21 23:37:32 +03:00
_editor Simplify Files navigation and preserve picker lifecycle 2026-09-17 04:23:42 +02:00
_email_integration Keep Email configuration as the sole plugin page 2026-09-12 17:28:23 +02:00
_error_retry Surface provider refusals and stop automatic retries 2026-09-23 15:19:12 +02:00
_goal Keep model prose as thoughts and retry silently 2026-11-01 06:50:49 +01:00
_infection_check Add file-level DOX docs & update AGENTS indexes 2026-06-08 12:41:53 +02:00
_kokoro_tts Add Paradee as the default voice in Local TTS 2026-10-08 21:36:02 +02:00
_memory Refine Quick Actions and add a compact half-width layout 2026-11-01 01:38:12 +01:00
_migrate_agents Document real agent migrations and preserve Claude chat history 2026-10-31 04:24:09 +01:00
_model_config Retry pending setup prompts after chat preset changes 2026-10-13 23:33:55 +02:00
_notify_user feat: add missing bundled plugin thumbnails 2026-10-27 18:40:11 +01:00
_oauth chore(oauth): bump Codex client version to 0.166.0 2026-11-01 06:55:59 +01:00
_office feat(office): enrich office log headlines without the agent prefix 2026-10-21 23:37:32 +03:00
_onboarding Update Codex onboarding defaults and preserve the current chat 2026-10-31 22:15:31 +01:00
_orchestrator feat(memory): unify memory tools under one action-based memory tool 2026-10-21 23:37:32 +03:00
_pin_to_top feat(plugins): move the tasks interface and scheduler task endpoints into the scheduler plugin 2026-10-21 23:37:31 +03:00
_plugin_installer Add channel plugin discovery to the welcome screen 2026-11-01 00:19:17 +01:00
_plugin_scan Add file-level DOX docs & update AGENTS indexes 2026-06-08 12:41:53 +02:00
_plugin_validator Unify WebUI icons and fix message collapsing 2026-07-31 13:32:41 +00:00
_promptinclude Handle empty promptinclude scans cleanly 2026-08-31 01:56:02 +02:00
_scheduler fix(scheduler): use Scheduled Tasks in modal and navigation 2026-11-01 20:13:55 +01:00
_search_engine feat: add missing bundled plugin thumbnails 2026-10-27 18:40:11 +01:00
_sidebar_folders Add configurable sidebar chat and message search 2026-10-31 03:12:00 +01:00
_skills Add profile skill visibility policies 2026-08-12 14:34:15 +02:00
_telegram_integration Reject unsupported Telegram configuration scopes 2026-11-01 08:05:25 +01:00
_text_editor feat(tools): drop agent prefix from tool log headlines 2026-10-21 23:37:32 +03:00
_time_travel fix(paths): resolve /a0 paths inside nested dev checkouts 2026-10-31 13:33:09 +03:00
_tool_access feat: add per-action permissions for bundled tools 2026-10-27 19:06:13 +01:00
_wait feat: add missing bundled plugin thumbnails 2026-10-27 18:40:11 +01:00
_whats_new refactor(webui): replace hardcoded accent blues with the highlight token 2026-10-13 18:06:47 +03:00
_whatsapp_integration Require explicit WhatsApp administrators for settings changes 2026-11-01 07:28:02 +01:00
_whisper_stt Improve Browser startup and annotations 2026-08-16 15:22:10 +02:00
AGENTS.md fix(scheduler): use Scheduled Tasks in modal and navigation 2026-11-01 20:13:55 +01:00
README.md refactor(skills): consolidate plugin authoring and discovery 2026-09-08 03:09:16 +02:00

Agent Zero - Core Plugins

This directory contains the system-level plugins bundled with Agent Zero.

Directory Structure

  • plugins/: Core system plugins. Reserved for framework updates — do not place custom plugins here.
  • usr/plugins/: The correct location for all user-developed and custom plugins. This directory is gitignored.

Documentation

For detailed guides on how to create, extend, or configure plugins, refer to:

What a Plugin Can Provide

Plugins are automatically discovered based on the presence of a plugin.yaml file. Each plugin can contribute:

  • Backend: API handlers, tools, helpers, named lifecycle extensions, and implicit @extensible hooks under extensions/python/_functions/...
  • Frontend: HTML/JS UI contributions via core extension breakpoints
  • Settings: Isolated configuration scoped per-project and per-agent profile
  • Activation: Global and scoped ON/OFF rules via .toggle-1 and .toggle-0 files, including advanced per-scope switching in the WebUI
  • Agent profiles: Plugin-distributed subagent definitions under agents/<profile>/agent.yaml

Backend extension layouts:

  • extensions/python/<point>/ for named lifecycle hooks
  • extensions/python/_functions/<module>/<qualname>/<start|end>/ for implicit @extensible hooks

Do not use the retired flattened extensions/python/<module>_<qualname>_<start|end>/ form.

Plugin Manifest

Every plugin requires a plugin.yaml at its root:

name: my_plugin              # required for community plugins
title: My Plugin
description: What this plugin does.
version: 1.0.0
settings_sections:
  - agent
per_project_config: false
per_agent_config: false
always_enabled: false

Plugin Script (execute.py)

Plugins can include an optional execute.py at the plugin root for user-triggered operations such as setup, post-install steps, maintenance, repairs, migrations, or resource refreshes. Users trigger it from the Plugin List UI.

Guidelines:

  • Treat it as a manual plugin script, not as the primary way to use the plugin
  • Prefer making it safe to rerun, or detect state and explain why a rerun is not appropriate
  • Return 0 on success and print progress messages for user feedback
  • Use hooks.py instead when the behavior is framework-internal or should happen automatically

Runtime Hooks (hooks.py)

Plugins can also include an optional hooks.py at the plugin root. The framework loads it on demand and can call exported hook functions by name through helpers.plugins.call_plugin_hook(...).

  • hooks.py runs inside the Agent Zero framework runtime and Python environment.
  • Use it for framework-internal work such as install hooks, cache preparation, registration, or filesystem setup.
  • If it runs sys.executable -m pip install ..., packages are installed into the same Python environment that runs Agent Zero.
  • If you need to install into the separate agent runtime or into the system environment, explicitly target that environment from a subprocess by selecting the correct interpreter, virtualenv, or package manager.

In Docker, hooks.py normally affects /opt/venv-a0; the agent execution runtime is /opt/venv.

Configuration Hook Context

Configuration hooks can distinguish why settings are being read or saved. Pass caller="ui" or caller="agent" to get_plugin_config(...) or save_plugin_config(...); calls without it keep the compatible default, "api".

The hook receives this as hook_context={"caller": ...}:

def get_plugin_config(default=None, hook_context=None, **kwargs):
    caller = (hook_context or {}).get("caller", "api")
    if caller == "ui":
        return redact_for_display(default)
    return default

Existing hooks need no change: hooks that ignore hook_context, including strict signatures without **kwargs, retain their previous behavior. Use the context only for behavior selection in plugin-controlled flows; it is not an authorization boundary. A config.html alone does not set the caller; the backend code loading or saving that configuration must pass it explicitly.

Plugin Index & Community Sharing

The Plugin Index at https://github.com/agent0ai/a0-plugins is the community-maintained registry of plugins available to all Agent Zero users.

To share a plugin with the community:

  1. Create a standalone GitHub repository with the plugin contents at the repo root. The runtime plugin.yaml must include a name field matching the intended index folder name. Add a LICENSE file at the repo root (required for Plugin Index listings so users have explicit terms of use).
  2. Fork https://github.com/agent0ai/a0-plugins and add a folder plugins/<your_plugin_name>/ containing a separate index manifest named index.yaml (not plugin.yaml):
title: My Plugin
description: What this plugin does.
github: https://github.com/yourname/your-plugin-repo
tags:
  - tools

Optional additional fields: screenshots (up to 5 image URLs).

  1. Open a Pull Request. CI validates the submission; a maintainer reviews and merges.

Note: The index index.yaml is a different file with a different schema from the runtime plugin.yaml. Folder names use ^[a-z0-9_]+$ (underscores, no hyphens) and must match the name field in the remote plugin.yaml exactly.

Plugin Hub

Agent Zero now includes a built-in Plugin Hub flow through the always-enabled Plugin Installer plugin. From the Plugins dialog, users can either open the Browse tab or click Install, which opens the installer modal on its own Browse tab.

The Plugin Hub surfaces Plugin Index entries directly in the UI and lets users search, filter, inspect, and install community plugins without leaving Agent Zero.