Track HolyCrab tasks and download results
A Task ID is the receipt number for one generation. Keep it so Codex can find the same task after a restart or network interruption.
Use Codex for the normal flow
1. Find recent tasks
Ask: Use HolyCrab to list my recent video tasks and show the newest first. You can also give a start date, end date, and type; start and end dates must be used together.
2. Wait on one task
Ask: Keep checking HolyCrab task TASK_ID until it finishes. Do not create another task. Replace TASK_ID with the receipt number you received.
3. Download the result
Ask Codex to download the completed task to a specific folder. If an image task returned several images, ask it to save all of them. It can also save video and all returned audio files, and asks before overwriting existing files.
If the connection broke after approval
- First list recent tasks and inspect the existing local submission record (the CLI calls it an attempt).
- If a Task ID exists, keep waiting on that task.
- If the result is unknown and no task appears, that still does not prove the online request failed. Do not submit the same paid request again.
- Only start a new generation when you knowingly want a second result and explicitly approve a new charge.
Resume a draft or its final
- Keep the draft and final Task IDs separate. A completed draft is a preview; its final is a separate 1080p or 4K task.
- Before conversion, ask Codex to check for an existing final and the draft expiry. If the final is processing or completed, continue with it. An expired draft does not prevent querying that existing final.
- If the final failed, first read the reason. Only request a new quote and approve another task when the draft is still valid and the service permits conversion. Do not retry automatically.
- If there is no reusable final and the draft is expired or unavailable, follow the returned reason. A new draft needs a separate estimate and approval.
I want to use the terminal
Show optional task commands
If it did not work
- A wait timeout is not a failed task; run the same wait again later.
- If a task fails, read the public error before changing the request.
- If download refuses an existing filename, choose another folder/name or explicitly decide whether to replace it.