Install beta

Install the local worker on a Mac and let the coordinator dispatch jobs to it.

The native packaged app is still coming. Today the beta path is the local Python worker with the same coordinator protocol.

1. Install the worker

uv venv
uv pip install -e ".[worker]"

This keeps the worker local while the hosted coordinator remains the only public service endpoint.

2. Enroll this Mac with the coordinator

hive init \
  --coordinator-url https://hivecompute.fly.dev \
  --enrollment-token <enrollment-token>

The manager issues short-lived enrollment tokens. Ask an admin to mint one from the manager dashboard.

3. Install the background service

hive install-service

This installs a per-user LaunchAgent so the worker starts at login without keeping a terminal open.

4. Verify or run manually when testing

hive status
hive doctor
hive logs --lines 120
# or run in the foreground
hive start
# or for local testing
hive start --no-idle-check

hive doctor checks config, Keychain access, LaunchAgent wiring, log paths, and coordinator reachability. Manual start is still useful while tuning idle rules and local models.

What is coming next

A packaged macOS app download instead of the CLI beta path.
User-managed worker preferences through a real app UI.
One-click packaging for launchd install, updates, and rollback.
Richer worker controls in the hosted manager instead of CLI-first service management.
Enrollment tokens are minted from the manager dashboard and should be short-lived.
Worker credentials are stored in macOS Keychain instead of the YAML config file.
The LaunchAgent writes logs under ~/.hive-compute/logs/.
Use hive logs --lines 200 to inspect LaunchAgent stdout/stderr without chasing the filenames manually.
The packaged macOS installer is still a follow-up; today the supported path is the CLI beta flow shown above.