• English

    • 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. HolyCrab can save image, video, and all returned audio files without overwriting existing files unless you explicitly allow it.

    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.

    I want to use the terminal

    Show optional task commands
    holycrab tasks list
holycrab tasks list --start-date 2026-09-01 --end-date 2026-09-14 --type VIDEO
holycrab tasks get TASK_ID
holycrab tasks wait TASK_ID --timeout 600
holycrab download TASK_ID --output ./holycrab-result.mp4
    holycrab generate attempts list
holycrab generate attempts get ATTEMPT_ID

    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.