Stably CLI

This package extends Playwright to add new AI functionality. To get started quickly, please see AI-assisted setup guide. Otherwise continue to read below.

Installation

npm i -g stably

🎭 Note
We let you bring your own Playwright version. This does mean that Playwright must first be setup (our CLI can help you do that)

Usage

Below is a short list of common commands. For a complete list, please use stably --help

• npx stably: This starts our REPL which will help with test creation or modifications
• npx stably test: Use this to run tests locally or in the CI
• npx stably --help: Will print full list of commands

Browsers

Stably runs your tests with your Playwright's browser, resolved from your project directory — not a version we pin. In a monorepo that means the @playwright/test in the package you run from, not the workspace root.

If that browser is not downloaded, the CLI runs npx playwright install chromium in your project directory for you. The download goes to Playwright's own browser cache (~/.cache/ms-playwright); nothing is written into your repository.

Set STABLY_BROWSER_AUTO_INSTALL=0 to turn that off. Stably then reports that verification is blocked, and lists every browser it considered and why each was unusable, instead of installing anything.

Authentication

Stably CLI supports two auth modes:

• API key via env vars (highest priority): set STABLY_API_KEY and STABLY_PROJECT_ID
• Browser login (OAuth): run npx stably login (credentials are stored locally)

If both are present, the CLI will honor the environment variables and warn that stored OAuth credentials are being ignored. To switch back to browser login, unset the env vars.