update CLI setup Skill for Flare Tunnel guidance
Users can connect to the A0 CLI via Flare Tunnel as well. Agents must know that.
Alessandro committed
Apr 12, 2026 at 18:27 UTC
435964506a6d3a83b5c7cbb1e150556b697b9870
1 file changed
+13
-3
skills/a0-setup-cli/SKILL.md
+13
-3
@@ -1,7 +1,7 @@
1
---
2
name: a0-setup-cli
3
description: Guide the user through installing and connecting the A0 CLI on the host machine so Dockerized Agent Zero can work on real local files. Use when asked to install A0, set up the CLI connector, connect Agent Zero to local files, or troubleshoot host-vs-container setup confusion.
4
-version: 1.0.0
4
+version: 1.1.0
5
author: Agent Zero Team
6
tags: ["agent-zero", "a0", "cli", "connector", "docker", "setup", "local-files"]
7
trigger_patterns:
@@ -106,7 +106,10 @@ Tell the user what to expect:
106
107
- `a0` opens the host picker first.
108
- If Agent Zero is running locally, `a0` may discover it automatically.
109
-- If not, the user can enter the Agent Zero web URL manually.
109
+- If not, the user can enter the Agent Zero web URL manually in the custom URL field.
110
+- The custom URL can be either a normal address with a port, such as `http://localhost:50001`, or a tunnel URL.
111
+- For Flare Tunnel, tell the user to open `Settings > External Services > Flare Tunnel`, click `Create Tunnel`, then copy and paste the HTTPS URL into `a0` exactly as shown.
112
+- Tunnel URLs such as `https://example.trycloudflare.com` do not need a port appended.
113
- `AGENT_ZERO_HOST` can prefill the target host without bypassing the picker.
114
115
Example:
@@ -116,6 +119,13 @@ export AGENT_ZERO_HOST=http://localhost:50001
119
a0
120
```
121
122
+Tunnel example:
123
+
124
+```bash
125
+export AGENT_ZERO_HOST=https://example.trycloudflare.com
126
+a0
127
+```
128
+
129
### 8. Define success clearly
130
131
Successful setup looks like this:
@@ -130,7 +140,7 @@ Successful setup looks like this:
140
- If the user says they installed inside Docker or shows `/a0` paths, redirect them to the host-machine install.
141
- If `a0` gets a connector `404`, explain that the running Agent Zero build likely does not include the builtin `_a0_connector` support yet and should be updated.
142
- If the browser UI works but `a0` does not, remind them the web UI can run without connector support but the CLI cannot.
133
-- If Docker discovery does not find the instance, have them enter the exact Agent Zero URL or set `AGENT_ZERO_HOST`.
143
+- If Docker discovery does not find the instance, have them enter the exact Agent Zero URL with `host:port`, or create a Flare Tunnel in `Settings > External Services > Flare Tunnel` and paste that HTTPS URL directly.
144
145
## Example Requests And Responses
146