vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-06-02 07:11:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
agent-zero/plugins/_acp
History
Alessandro 46112c9750
Some checks are pending
Build And Publish Docker Images / plan (push) Waiting to run
Details
Build And Publish Docker Images / build (push) Blocked by required conditions
Details
Add builtin ACP plugin 
Expose Agent Zero over the Agent Client Protocol as a builtin stdio plugin with session lifecycle support, streaming bridges, registry metadata, and editor workspace handling.

Add lazy dependency installation through the ACP plugin hook using the root requirements pin so self-updated instances can recover without a fresh Docker image.

Pin agent-client-protocol, add focused static coverage, and allow ACP sessions to override the per-context workdir for code execution and workdir prompts.
2026-06-01 02:40:28 +02:00
..
acp_registry Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
extensions/python Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
helpers Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
webui Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
__init__.py Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
__main__.py Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
entry.py Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
hooks.py Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
plugin.yaml Add builtin ACP plugin 2026-06-01 02:40:28 +02:00
README.md Add builtin ACP plugin 2026-06-01 02:40:28 +02:00

README.md

Agent Client Protocol

This builtin plugin exposes Agent Zero through the Agent Client Protocol (ACP) over stdio so ACP-capable editors can create, load, resume, and prompt Agent Zero sessions directly from a workspace.

Usage

From the Agent Zero repository or runtime container:

python -m plugins._acp

For the Dockerized Agent Zero runtime, point the editor command at the framework interpreter inside the container, for example:

docker exec -i agent-zero /opt/venv-a0/bin/python -m plugins._acp

ACP reserves stdout for JSON-RPC, so the adapter writes diagnostics to stderr.

Checks

python -m plugins._acp --check
python -m plugins._acp --registry

The ACP Python SDK is provided by agent-client-protocol. Fresh Docker images install it through the root requirements.txt; self-updated instances lazy-install the same root pin through plugins/_acp/hooks.py the first time the ACP stdio entrypoint starts.