@meego-harness/worker-cli
v0.3.0
Published
Unified worker discovery and management CLI for meego-harness
Readme
@meego-harness/worker-cli
Unified worker discovery, provisioning, runtime control, and diagnostics CLI for meego-harness.
Install:
pnpm add @meego-harness/worker-cliIf you are testing from a local workspace checkout before publish, use pnpm exec meego-harness-worker ....
Top-level commands:
meego-harness-worker onboard
meego-harness-worker onboard --all --json
meego-harness-worker start --worker codex-worker-1 --tmux
meego-harness-worker start --all
meego-harness-worker start --resume
meego-harness-worker stop --worker codex-worker-1
meego-harness-worker stop --all
meego-harness-worker stop --tmux-only
meego-harness-worker doctor
meego-harness-worker doctor --fixonboard
onboard is the only provisioning and management entrypoint. It does not start workers.
Interactive onboard can:
- search npmjs and configured registries
- install missing worker packages
- create new worker instances
- delete configured worker instances
- add or remove registries
- refresh managed registry authentication
- set machine-level defaults for
serverUrlandemail - save, apply, and remove machine-local profiles
Examples:
meego-harness-worker onboard
meego-harness-worker onboard codex
meego-harness-worker onboard --all
meego-harness-worker onboard --jsononboard --all installs every discovered worker package but does not run setup or start.
onboard --json prints the current worker-cli state snapshot, including packages, instances, registries, defaults, profiles, and a summary of changes.
start
start only controls runtime startup.
meego-harness-worker start --worker codex-worker-1 --tmux
meego-harness-worker start --all
meego-harness-worker start --resumeNotes:
--tmuxis only supported for workers whose manifest declaresruntimeKind = foreground-process.start --resumerestarts instances previously marked bystop --all.
stop
stop only controls runtime shutdown.
meego-harness-worker stop --worker codex-worker-1
meego-harness-worker stop --all
meego-harness-worker stop --tmux-onlyNotes:
stop --allrecords the last known start mode for laterstart --resume.stop --tmux-onlyonly killsworker-climanaged tmux sessions.
doctor
doctor performs health diagnostics across environment, registries, packages, and worker instances.
meego-harness-worker doctor
meego-harness-worker doctor --worker codex-worker-1
meego-harness-worker doctor --fixdoctor --fix only applies explicit fixable actions such as:
- installing
tmux - refreshing registry authentication
- reinstalling a missing worker package
- removing dangling worker instance records
It does not auto-fix high-risk host-service or worker-specific business configuration issues.
