Commands
Command Reference
Complete reference for all alethia CLI commands organized by group.
Command Reference
alethia provides 27 commands across 7 groups. All commands communicate with the Alethia API — they do not execute Terraform directly.
Command Tree
alethia
├── login [--force]
├── logout
├── zone
│ ├── create --name <name>
│ ├── list
│ └── delete --id <id>
├── spec
│ ├── list [--zone-id <id>]
│ └── get --id <id>
├── plan [--spec-id <id>] [--worker-id <id>] [--wait]
├── apply [--spec-id <id>] [--worker-id <id>] [--plan-job-id <id>] [--wait]
├── destroy
│ ├── spec --spec-id <id> [--worker-id <id>] [--wait]
│ ├── worker --worker-id <id>
│ └── zone --zone-id <id>
├── jobs
│ ├── list
│ ├── get --id <id>
│ ├── logs --id <id> [--follow]
│ ├── cancel --id <id>
│ └── wait --id <id>
├── worker
│ ├── start
│ ├── register
│ ├── list
│ ├── remove --id <id>
│ └── config
├── clusters
│ └── list
└── selectorsInteractive Selection
When --spec-id is omitted from plan, apply, or destroy, alethia launches an interactive TUI selector. See TUI Components for how this works.
Common Patterns
Plan-Review-Apply
# 1. Plan
alethia plan --spec-id <id>
# Note the job ID from output
# 2. Stream logs to review
alethia jobs logs --id <plan-job-id> --follow
# 3. Apply
alethia apply --spec-id <id> --plan-job-id <plan-job-id>Scripting with --wait
# Block until plan completes, then apply
alethia plan --spec-id <id> --wait
alethia apply --spec-id <id> --plan-job-id <id> --waitLog Tailing
# Stream logs like tail -f
alethia jobs logs --id <job-id> --follow