Job Commands

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

grape jobs list

List all jobs for the authenticated user.

grape jobs list

Output:

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

grape jobs get

Get detailed information about a specific job.

grape jobs get --id <job-id>

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

grape jobs logs

Stream job logs to the terminal.

grape 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 Tendril writes them. Logs include Terraform plan/apply output, resource creation progress, and error messages.

Press Ctrl+C to stop following.

grape jobs cancel

Cancel a queued or in-progress job.

grape jobs cancel --id <job-id>

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

grape jobs wait

Block until a job reaches a terminal state.

grape jobs wait --id <job-id>

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

grape plan --vine-id $ID
grape jobs wait --id $PLAN_JOB && echo "Plan succeeded"