kitaru worker start
Run a generic local worker in the foreground without durable provider binding. The first SIGINT or SIGTERM requests a safe drain of held tasks.
Usage
kitaru worker start [OPTIONS]Supported --output modes: auto, text, json, jsonl.
Options
| Name | Type | Required | Description |
|---|---|---|---|
--name | string | No | Ephemeral worker name. |
--claim | agent|evaluator|importer|agent=UUID[] | No | Claim the worker serves: agent, evaluator, importer, or agent=AGENT_VERSION_ID. Repeat for multiple claims. |
--selector | KEY=[VALUE[,VALUE]][]|JSON[] | No | Task label selectors, combined by conjunction. |
--job-id | UUID | No | Restrict claims to one job. |
--concurrency | positive integer | No | Maximum held tasks. |
--claim-batch-size | positive integer | No | Maximum tasks per claim. |
--poll-interval | positive float | No | Idle polling interval. |
--heartbeat-interval | positive float | No | Heartbeat interval. |
--timeout | positive float | No | Worker lifetime in seconds. |
--drain-timeout | positive float | No | Seconds to wait for held tasks before canceling them. |
--blob-cache-root | path | No | Blob cache directory. |
--payload-cache-root | path | No | Payload cache directory. |
--metadata | KEY=VALUE[] | No | Worker registration metadata. |
--log-level | string | No | Log level for worker runtime logs: debug, info, warning, or error. |
Every command also accepts the global options listed on the CLI overview page.