agent-zero/docs/guides/a0-cli-connector.md
Alessandro 954eca3563 add a0-setup-cli Skill and restore lexical trigger matching
Add a builtin `a0-setup-cli` skill for guiding host-side A0 connector setup,
and restore the lightweight trigger-word based skill matching flow, which many users asked for.

- add builtin `skills/a0-setup-cli/` with installer-first host setup guidance,
  container guardrails, fallback install paths, and example responses
- fix `helpers.skills_cli` so builtin skills under `/skills` are discoverable,
  searchable, and validatable
- restore trigger-pattern scoring in runtime `search_skills()`
- re-enable `skills_tool:search` in the current tool flow
- add lightweight lexical relevant-skill recall for the current user message
  without reintroducing memory/vector-db skill recall
- update skill prompts to steer the agent toward search/load when requests
  match skill trigger phrases
2026-04-11 18:03:05 +02:00

2.3 KiB

A0 CLI Connector

Agent Zero lives in Docker for a reason. That keeps it safer. The problem is that people see Docker and assume the agent can never really touch the code on their computer.

A0 CLI is the answer to that.

Agent Zero stays in Docker. A0 CLI installs on the host machine. That is what lets Agent Zero finally work on the real files on your real computer.

For now, use the install commands below.

Quick Install

macOS / Linux:

curl -LsSf https://raw.githubusercontent.com/agent0ai/a0-connector/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/agent0ai/a0-connector/main/install.ps1 | iex

Manual fallback when uv is already installed or if URLs give 404:

uv tool install git+https://github.com/agent0ai/a0-connector

Run these on the host machine, not inside the Agent Zero container.

The installer uses uv, and uv will select or download a compatible Python if needed.

Open it and start working

  1. Make sure Agent Zero is already running.
  2. Launch A0 CLI on the host machine:
a0
  1. If Agent Zero is running on the same machine, A0 CLI will usually find it for you.
  2. If Agent Zero is somewhere else, enter the exact web address or set AGENT_ZERO_HOST as env variable before launching a0.
  3. Open or create a chat and confirm you can talk to Agent Zero from the host machine.

Note

Current Agent Zero builds starting from v1.9 include the builtin connector support that A0 CLI expects. If you see a connector-specific 404, update Agent Zero first.

Give this to another agent

If another agent is helping with setup, do not paste a whole checklist. Paste one line:

Set up the A0 CLI connector for Agent Zero on this machine using the a0-setup-cli Skill.

Troubleshooting

  • Nothing appears locally: Enter the Agent Zero web address manually or export AGENT_ZERO_HOST.
  • You tried to install from inside Docker: A0 CLI belongs on the host machine. Agent Zero stays in Docker.
  • Function keys do nothing: Some terminals and IDEs capture function keys. Use Ctrl+P.
  • Connector route returns 404: Update Agent Zero to a build with builtin connector support.