\n \n\n# Stably CLI\n\nThis package extends Playwright to add new AI functionality.\nTo get started quickly, please see [AI-assisted setup guide](https://docs.stably.ai/getting-started/sdk-setup-guide). Otherwise continue to read below.\n\n## Installation\n```shell\nnpm i -g stably\n```\n\n> 🎭 **Note** \n> We let you bring your own Playwright version.\n> This does mean that Playwright must first be setup (our CLI can help you do that)\n\n## Usage\nBelow is a short list of common commands. For a complete list, please use `stably --help`\n\n * `npx stably`: This starts our REPL which will help with test creation or modifications\n * `npx stably test`: Use this to run tests locally or in the CI\n * `npx stably --help`: Will print full list of commands\n\n## Browsers\n\nStably 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.\n\nIf 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.\n\nSet `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.\n\n## Authentication\nStably CLI supports two auth modes:\n\n- **API key via env vars (highest priority)**: set `STABLY_API_KEY` and `STABLY_PROJECT_ID`\n- **Browser login (OAuth)**: run `npx stably login` (credentials are stored locally)\n\nIf 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.\n\n","readmeFilename":"README.md"}
![](\"https://public-artifacts.stably.ai/logo-white-with-bg.png\"){kind=logo}
\n