@cloudagentfleet/worker
v0.1.6
Published
Cloud Agent Fleet Worker — machine companion and operator CLI.
Readme
@cloudagentfleet/worker
Cloud Agent Fleet Worker — machine companion and operator CLI.
Requires Node.js 22.6+. Codeman should be installed and running on the machine (codeman web) when you want live sessions.
Install
npm install --global @cloudagentfleet/worker
cloudagentfleet --helpOr in a folder:
mkdir -p ~/cloudagentfleet-worker && cd ~/cloudagentfleet-worker
npm install @cloudagentfleet/worker
npx cloudagentfleet --helpQuick start
Same HOSTED_AGENTS_AUTH_TOKEN as the Hub is required (Hub UI auth rejects
Worker enroll without it). Codeman should already be running (codeman web).
export HOSTED_AGENTS_AUTH_TOKEN="replace-with-a-long-shared-secret"
cloudagentfleet setup --runUse the Hub’s reachable URL as Controller URL (not 127.0.0.1 if Hub is on
another machine). Note the Worker ID printed/chosen during setup.
Enroll so the Hub UI shows an instance
The dashboard lists instances, not raw Workers. After the Worker is online:
export HOSTED_AGENTS_AUTH_TOKEN="replace-with-a-long-shared-secret"
cloudagentfleet enroll connector \
--controller-url http://<hub-host>:8787 \
--instance-id codeman-1 \
--name "My Codeman" \
--node-id <worker-id-from-setup> \
--workspace-mode folders \
--workspace-root "$HOME/workspaces"Restart the Worker (cloudagentfleet worker stop / start, or re-run
cloudagentfleet setup --run) so it uses CODEMAN_INSTANCE_ID=codeman-1.
Check:
curl -H "Authorization: Bearer $HOSTED_AGENTS_AUTH_TOKEN" http://<hub-host>:8787/api/workers
curl -H "Authorization: Bearer $HOSTED_AGENTS_AUTH_TOKEN" http://<hub-host>:8787/api/instancesUseful commands
cloudagentfleet doctor
cloudagentfleet hub serve
cloudagentfleet hub status
cloudagentfleet hub stop
cloudagentfleet worker stop
cloudagentfleet worker removehosted-agents is a compatibility alias for cloudagentfleet.
Binaries
| Command | Role |
| --- | --- |
| cloudagentfleet | Operator CLI (setup, enroll, hub, worker, doctor) |
| cloudagentfleet-worker | Worker runtime process |
| hosted-agents | Alias for cloudagentfleet |
Published contents are compiled CLI bundles under dist/ only.
Related packages
Source and docs: hirenf14/cloudagentfleet
