How warpdotdev/oz-agent-worker works
oz-agent-worker is a self-hosted daemon that receives cloud-agent assignments from Oz over WebSocket and runs them on operator-managed infrastructure. Its principal flow is startup configuration, server connection and assignment handling, backend execution, then task status/log reporting; Docker, Direct, Kubernetes, and Command are alternative execution modes, not sequential stages. The README also documents image remapping, one-shot Direct workers, and task telemetry. Edges are limited to README statements and shown source/index references; some backend wiring and unsampled subsystem links are therefore omitted.
Main entry points: worker.go Worker lifecycle · backend.go Backend selection · main.go Worker entrypoint · exporter.go OTLP export
Components 18
Startup
- Worker entrypoint
main.go - Config loading
internal/config/config.go
Task coordination
- Worker lifecycle
internal/worker/worker.go - Task protocol
internal/types/messages.go
Execution backends
- Backend selection
internal/worker/backend.go - Docker execution
internal/worker/docker.go - Direct execution
internal/worker/direct.go - Kubernetes execution
internal/worker/kubernetes.go - Command execution
internal/worker/command.go - Task argument building
internal/common/task_utils.go - Image remapping
internal/common/image_remapping.go
Task telemetry
- Worker metrics
internal/metrics/metrics.go - Task log reporting
internal/tasktelemetry/log/reporter.go - Task tracing
internal/tasktelemetry/tracing/session.go - OTLP export
internal/tasktelemetry/otlp/exporter.go
Other components
- Operator
- Oz server
- Telemetry collector
Connections 21
- Operator → Worker entrypoint: configures
README.md - Worker entrypoint → Config loading: loads settings
main.go - Worker entrypoint → Worker lifecycle: starts
main.go - Worker lifecycle → Oz server: connects by WebSocket
README.md - Oz server → Worker lifecycle: assigns tasks
README.md - Worker lifecycle → Task protocol: handles messages
internal/worker/worker.go - Worker lifecycle → Backend selection: selects backend
- Backend selection → Docker execution: dispatches execution
- Backend selection → Direct execution: dispatches execution
- Backend selection → Kubernetes execution: dispatches execution
- Backend selection → Command execution: dispatches execution
- Direct execution → Task argument building: uses arguments
internal/common/task_utils.go - Docker execution → Image remapping: remaps images
README.md - Kubernetes execution → Image remapping: remaps images
README.md - Worker lifecycle → Worker metrics: records task metrics
internal/worker/worker.go - Worker lifecycle → Task log reporting: reports task logs
- Worker lifecycle → Task tracing: starts task traces
internal/worker/worker.go - Task tracing → OTLP export: creates exporter
internal/tasktelemetry/tracing/session.go - Task log reporting → OTLP export: creates exporter
internal/tasktelemetry/log/reporter.go - OTLP export → Telemetry collector: exports telemetry
internal/tasktelemetry/otlp/exporter.go - Worker lifecycle → Oz server: reports task status
internal/worker/worker.go