Skip to main content

Run tests with a generic shell

Use this recipe when your CI provider does not have a dedicated page, or when you want one script that works in any pipeline. The script starts a Qodex run, polls until it finishes, and exits non-zero when the run fails or times out.

Before you start

You need:
  • A Qodex project with runnable scenarios.
  • A project API key from Settings > Workspace > API keys.
  • bash, curl, and jq on the runner.

Add the script

Save this file at scripts/qodex-run.sh and make it executable.

Run it

Add it to any CI provider

The CI provider only needs to expose QODEX_PROJECT and QODEX_API_KEY as environment variables, then run the script as a normal step.
The job passes only when the Qodex run reaches completed. HTTP errors, failed or stopped runs, and timeouts fail the job. See run status values.

Run tests via webhook

Run tests in CI