Documentation

A0 CLI Connector

Install A0 CLI connector on your host machine, connect it to Agent Zero, and start working on your local code and files.

How it works

Agent Zero stays in its sandboxed environment. A0 CLI installs and runs on your own machine. That is what lets Agent Zero work on the files already on your computer without giving up the Docker boundary.

Step 1: Install A0 CLI

Run this on your computer, not inside the Agent Zero container. Use the install commands below.

# One command. Then Agent Zero can work on this machine.
$ curl -LsSf https://cli.agent-zero.ai/install.sh | sh
# One command. Then Agent Zero can work on this machine.
> irm https://cli.agent-zero.ai/install.ps1 | iex

Step 2: Open it and start working

After that, connect it to Agent Zero and make sure the session is running from your own machine.

  1. Make sure Agent Zero is already running.
  2. Run a0 on your own machine.
  3. If Agent Zero is running on the same machine, A0 CLI will find it automatically.
  4. If it does not, enter the Agent Zero web address manually before launching a0.
  5. Open a chat and confirm you are talking to Agent Zero from your own machine. That is how you know it is working.

Need help? Ask your agent to guide you.

Copy the brief and move on.

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

Troubleshooting

  • No local instance appears: enter the Agent Zero web address manually, or set AGENT_ZERO_HOST variable with the WebUI URL before launching a0.
  • You tried to install it inside Docker: install A0 CLI on your own machine instead. Only Agent Zero stays in Docker.
  • You see a connector 404: update Agent Zero to a build that includes connector support. The connector is available from version 1.9 onwards.