vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-09 17:08:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
agent-zero/webui/components/settings/AGENTS.md
Alessandro bc96386260 Add External Services plugin settings section 
Expose plugins that declare the external settings section from the External Services settings page.

Wire the sidebar item, subsection mount, and settings DOX contract so plugin sections use matching tab IDs.
2026-07-09 13:20:48 +02:00

2.2 KiB
Raw Permalink Blame History

Settings Components DOX

Purpose

  • Own WebUI settings shell and built-in settings subsections.

Ownership

  • settings.html and settings-store.js own the settings shell and state.
  • Subdirectories own settings areas such as agent, external, developer, MCP, backup, plugins, secrets, skills, tunnel, and A2A.
  • mcp/client/ owns the global/project MCP server manager, server search, raw JSON editor surface, examples modal, server tool detail modal, MCP scanner modal, scan checks, and scan prompt assets.
  • skills/ owns skill listing, importing, standalone skill scanning, uploaded archive scan preparation UI, scanner modal, scan checks, and scan prompt assets.

Local Contracts

  • Keep settings payloads synchronized with backend APIs and plugin settings contracts.
  • Settings tabs that expose plugin settings_sections must mount settings/plugins/plugins-subsection.html with matching data-tab and sidebar/nav section IDs.
  • Do not store secrets in localStorage, URLs, or console output.
  • Preserve Store Gating and modal footer conventions in settings components.
  • MCP manager tool toggles write disabled_tools into the draft JSON and require Apply before changing the running MCP tool set.
  • Confirmed MCP server removals apply immediately and refresh server status; other MCP manager draft edits still require Apply.
  • MCP manager local command forms accept shell-style command and argument lines; quote argument values that intentionally contain spaces.

Work Guidance

  • Prefer subsection-local stores for complex settings areas.
  • Coordinate plugin settings UI changes with webui/components/plugins/ and plugins/AGENTS.md.
  • Keep MCP scanner checks and prompt assets close to the MCP client modal so scanner behavior remains reviewable with the UI that invokes it.
  • Keep Skills scanner checks and prompt assets close to the Skills settings section so scanner behavior remains reviewable with import and standalone scan entry points.
  • Keep MCP manager search and toggle affordances consistent between global and project scope because both are rendered by the same client modal.

Verification

  • Smoke-test changed settings tabs and save/reload behavior after visible or API changes.

Child DOX Index

No child DOX files.