Skip to main content

Overview

The cloud.setupScript field in stably.yaml allows you to run a bash script during agent session initialization. This is useful for projects that have CI-generated files not in the repository but required for tests to run.
When to use cloud.setupScript vs postinstall: Use cloud.setupScript for setup that should only run in Stably’s cloud environment. If you need the same setup to run locally and in your own CI, add it to your postinstall script instead.

Use Cases


Configuration

Add a cloud section to your stably.yaml with a setupScript field:
stably.yaml

Configuration Options

Stably automatically runs dependency installation (npm install, pnpm install, etc.) before your setup script executes. You don’t need to include dependency installation commands in your script.
Your script runs from the directory where stably.yaml is located.

The stably.yaml file supports additional configuration for other Stably features:

Scheduled Runs

Configure automated test schedules with cron expressions

CLI Agent Configuration

Customize stably fix behavior with rules and limits