@ai-development-environment/control-agent 0.0.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,36 @@
1
+ # @ai-development-environment/control-agent
2
+
3
+ Control agent for the [AI Development Environment](https://github.com/bludesign/ai-development-environment). It makes authenticated outbound HTTP and GraphQL WebSocket connections to the control plane; managed machines do not expose a listening port.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install -g @ai-development-environment/control-agent
9
+ ```
10
+
11
+ Requires Node.js 24 (`>=24.16.0 <25`). Running Cloudflared jobs additionally requires [`cloudflared`](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) on the `PATH` (for example `brew install cloudflared`) — `control-agent doctor` checks for it.
12
+
13
+ ## Usage
14
+
15
+ Open the server's **Agents** page and create a one-time enrollment command, then run it on the target machine (the server defaults to the same computer when omitted):
16
+
17
+ ```bash
18
+ control-agent enroll \
19
+ --server http://127.0.0.1:3090 \
20
+ --enrollment-token <one-time-token>
21
+ control-agent run
22
+ ```
23
+
24
+ Diagnostics:
25
+
26
+ ```bash
27
+ control-agent status
28
+ control-agent doctor
29
+ ```
30
+
31
+ The credential and stable agent ID are stored at `~/.config/control-agent/config.json`.
32
+
33
+ ## See also
34
+
35
+ - [`@ai-development-environment/server`](https://www.npmjs.com/package/@ai-development-environment/server) — the control-plane server.
36
+ - The [Homebrew tap](https://github.com/bludesign/homebrew-ai-development-environment) — alternative install that runs the agent as a `brew services` daemon.