@cloudagentfleet/worker 0.1.1 → 0.1.3

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.
Files changed (3) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +89 -0
  3. package/package.json +4 -2
package/CHANGELOG.md ADDED
@@ -0,0 +1,13 @@
1
+ # @cloudagentfleet/worker
2
+
3
+ ## 0.1.3
4
+
5
+ ### Patch Changes
6
+
7
+ - [`c659eba`](https://github.com/hirenf14/cloudagentfleet/commit/c659eba74f7328de378d9f73799bf6c938b7f7a3) Thanks [@hirenf14](https://github.com/hirenf14)! - Add package READMEs with install and start instructions for npm.
8
+
9
+ ## 0.1.1
10
+
11
+ ### Patch Changes
12
+
13
+ - [`ad68c04`](https://github.com/hirenf14/cloudagentfleet/commit/ad68c04bf6bcd4419f007e609d1fd6a3fcef339a) Thanks [@hirenf14](https://github.com/hirenf14)! - Initial public release of Cloud Agent Fleet Hub, UI, and Worker packages.
package/README.md ADDED
@@ -0,0 +1,89 @@
1
+ # @cloudagentfleet/worker
2
+
3
+ Cloud Agent Fleet Worker — machine companion and operator CLI.
4
+
5
+ Requires Node.js **22.6+**. Codeman should be installed and running on the machine (`codeman web`) when you want live sessions.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npm install --global @cloudagentfleet/worker
11
+ cloudagentfleet --help
12
+ ```
13
+
14
+ Or in a folder:
15
+
16
+ ```bash
17
+ mkdir -p ~/cloudagentfleet-worker && cd ~/cloudagentfleet-worker
18
+ npm install @cloudagentfleet/worker
19
+ npx cloudagentfleet --help
20
+ ```
21
+
22
+ ## Quick start
23
+
24
+ Point the Worker at a running Hub, then configure and start:
25
+
26
+ ```bash
27
+ cloudagentfleet setup --run
28
+ ```
29
+
30
+ Or install as a user service:
31
+
32
+ ```bash
33
+ cloudagentfleet setup
34
+ cloudagentfleet worker install
35
+ cloudagentfleet worker start
36
+ cloudagentfleet worker status
37
+ ```
38
+
39
+ ## Enroll with the Hub
40
+
41
+ Connector mode (Worker-backed):
42
+
43
+ ```bash
44
+ cloudagentfleet enroll connector \
45
+ --controller-url http://127.0.0.1:8787 \
46
+ --instance-id codeman-1 \
47
+ --name "My Codeman" \
48
+ --node-id worker-1
49
+ ```
50
+
51
+ Direct Tailscale mode (preferred when Codeman is reachable on the tailnet):
52
+
53
+ ```bash
54
+ cloudagentfleet enroll tailscale-url \
55
+ --controller-url http://127.0.0.1:8787 \
56
+ --instance-id codeman-1 \
57
+ --name "My Codeman" \
58
+ --url https://codeman.tailnet.ts.net
59
+ ```
60
+
61
+ ## Useful commands
62
+
63
+ ```bash
64
+ cloudagentfleet doctor
65
+ cloudagentfleet hub serve
66
+ cloudagentfleet hub status
67
+ cloudagentfleet hub stop
68
+ cloudagentfleet worker stop
69
+ cloudagentfleet worker remove
70
+ ```
71
+
72
+ `hosted-agents` is a compatibility alias for `cloudagentfleet`.
73
+
74
+ ## Binaries
75
+
76
+ | Command | Role |
77
+ | --- | --- |
78
+ | `cloudagentfleet` | Operator CLI (setup, enroll, hub, worker, doctor) |
79
+ | `cloudagentfleet-worker` | Worker runtime process |
80
+ | `hosted-agents` | Alias for `cloudagentfleet` |
81
+
82
+ Published contents are compiled CLI bundles under `dist/` only.
83
+
84
+ ## Related packages
85
+
86
+ - [`@cloudagentfleet/hub`](https://www.npmjs.com/package/@cloudagentfleet/hub)
87
+ - [`@cloudagentfleet/ui`](https://www.npmjs.com/package/@cloudagentfleet/ui)
88
+
89
+ Source and docs: [hirenf14/cloudagentfleet](https://github.com/hirenf14/cloudagentfleet)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cloudagentfleet/worker",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "private": false,
5
5
  "description": "Cloud Agent Fleet Worker — machine companion and operator CLI.",
6
6
  "type": "module",
@@ -10,7 +10,9 @@
10
10
  "hosted-agents": "./dist/cloudagentfleet.mjs"
11
11
  },
12
12
  "files": [
13
- "dist"
13
+ "dist",
14
+ "README.md",
15
+ "CHANGELOG.md"
14
16
  ],
15
17
  "publishConfig": {
16
18
  "access": "public",