Job Commands

Monitor and manage provision jobs from the terminal. For how jobs work internally, see Job Queue Pattern.

alethia jobs list

List all jobs for the authenticated user.

alethia jobs list

Output:

ID            TYPE     STATUS      SPEC            CREATED
a1b2...       PLAN     SUCCESS     api-backend     2 min ago
c3d4...       DEPLOY   PROCESSING  api-backend     30 sec ago
e5f6...       DESTROY  QUEUED      data-platform   just now

alethia jobs get

Get detailed information about a specific job.

alethia jobs get --id <job-id>

Shows: type, status, assigned Runner, all timestamps, error message (if failed), and execution metadata (Terraform outputs, cost data).

alethia jobs logs

Stream job logs to the terminal.

alethia jobs logs --id <job-id> [--follow]

Without --follow, prints all existing logs and exits. With --follow, the command blocks and prints new log lines as the Runner writes them. Logs include Terraform plan/apply output, resource creation progress, and error messages.

Press Ctrl+C to stop following.

alethia jobs cancel

Cancel a queued or in-progress job.

alethia jobs cancel --id <job-id>

Sets the job status to CANCELLED. If the job is currently being executed by a Runner, the Runner detects the cancellation on its next status check and terminates Terraform gracefully.

alethia jobs wait

Block until a job reaches a terminal state.

alethia jobs wait --id <job-id>

Exits with code 0 on SUCCESS, non-zero on FAILED or CANCELLED. Useful in scripts:

alethia plan --spec-id $ID
alethia jobs wait --id $PLAN_JOB && echo "Plan succeeded"