Worker Commands
Register, list, configure, and remove Runner agents from the CLI.
Worker Commands
Manage Runner execution agents from the terminal.
alethia worker start
Start the Runner polling loop (self-hosted mode).
alethia worker startThis starts the Runner agent locally — it polls for jobs, executes Terraform, and streams logs. Requires a registered worker with credentials stored in ~/.config/alethia/worker.json.
See Self-Hosted Mode for prerequisites and setup.
alethia worker register
Register a new self-hosted Runner.
alethia worker registerInteractive form prompts for a worker name. On success:
- Generates a
worker_idandworker_token - Saves credentials to
~/.config/alethia/worker.json - Prints the credentials for reference
The worker token is generated once and saved locally. If the config file is lost, the Runner must be re-registered. See Authentication Flows.
alethia worker list
List all registered Runners.
alethia worker listOutput:
ID NAME STATUS MODE VERSION LAST HEARTBEAT
a1b2... eu-west-1-runner ONLINE cloud-hosted 0.1.0 5 sec ago
c3d4... self-hosted-dev OFFLINE self-hosted 0.1.0 2 min agoalethia worker config
Display the current worker configuration from ~/.config/alethia/worker.json.
alethia worker configShows the stored worker ID, token presence, and API endpoint.
alethia worker remove
Remove a registered Runner.
alethia worker remove --id <worker-id>| Flag | Required | Description |
|---|---|---|
--id | Yes | Worker UUID |
For cloud-hosted Runners, this also queues a DESTROY_WORKER job to tear down the ECS infrastructure. For self-hosted Runners, it simply removes the registration from Alethia.