Back to Agent Zero

Agent Editor

plugins/_agent_editor/README.md

2.91.5 KB
Original Source

Agent Editor

Agent Editor provides the deterministic Easy modal and Advanced workspace for Agent Zero profiles. It reads the existing layered profile architecture and writes only sparse overrides in the selected Global or project profile layer.

The editor never invokes a model. Tool and skill controls are backed by the central runtime policy owners, and every save is previewed as exact file writes and deletions before the same validated plan is applied.

Easy and Advanced use the same segmented capability policy: On pins an item allowed, Off pins it blocked, and Default follows the profile's Tools, MCPs, or Skills default switch. Easy places each chooser below its default switch; Advanced gives Tools, MCPs, and Skills separate searchable sections and adds retained unavailable entries plus ACE-based prompt editing.

Global agents and customizations live under usr/agents/<profile-id> and apply across projects. Project-scoped agents and customizations live under usr/projects/<project>/.a0proj/agents/<profile-id>, inherit the Global layer, and can be removed without changing it.

Manage agents can duplicate the effective profile into the selected scope and toggle whether each profile is available there. Project availability reuses .a0proj/agents.json; Global availability is a sparse profile override. The selected scope must always keep at least one profile available. The bundled default profile remains the internal inheritance baseline and is not offered as a selectable or editable profile.