Stably CLI

# Get your API key from https://app.stably.ai/settings
export STABLY_API_KEY=stably_...

# Or authenticate interactively
npx stably auth login

cd /path/to/your/project
npx stably connect

# This creates a stably.config.yaml and links to your Stably project

# Start the interactive session
npx stably

> "Create a test for the checkout flow"
✓ Test created: tests/checkout.spec.ts

> "Add assertions for the order confirmation page"
✓ Updated test with new assertions

> "Run it"
✓ Running tests...

# Generate a test from description
npx stably generate "test user registration with email validation"

# Generate from URL (records your actions)
npx stably record https://app.example.com/signup

# Import existing Playwright tests
npx stably import tests/*.spec.ts

# Run all tests locally
npx stably test

# Run specific group
npx stably test smoke

# Run with Playwright options
npx stably test --headed --project=chromium

# Run on Stably cloud
npx stably test smoke --cloud

# Or use the explicit command
npx stably cloud test smoke

# Parallel execution (sharding)
npx stably cloud test regression --shards 5

# Run tests and auto-fix failures
npx stably fix

# Fix specific group
npx stably fix smoke

# Dry run (show proposed fixes without applying)
npx stably fix --dry-run

# Interactive mode (review each fix)
npx stably fix --interactive

npx stably fix

# ✓ 45 tests passed
# ✗ 3 tests failed
# 
# Analyzing failures...
# 
# Test: checkout.spec.ts > complete purchase
# Issue: Selector '.checkout-button' not found
# Fix: Updated to '[data-testid="checkout-btn"]'
# Status: ✓ Fixed and verified
# 
# Test: login.spec.ts > invalid credentials
# Issue: Error message assertion failed
# Fix: Updated expected text to match new design
# Status: ✓ Fixed and verified
# 
# Test: search.spec.ts > filter results
# Issue: Timeout waiting for results
# Fix: Added explicit wait for API response
# Status: ⚠ Manual review needed (confidence: 0.72)
# 
# Summary: 2 auto-fixed, 1 needs review

stably                          # Start interactive AI agent
stably generate DESCRIPTION     # Generate test from description
stably record [url]             # Record test by clicking through app
stably test [group]             # Run tests locally
stably cloud test GROUP         # Run tests on Stably cloud
stably fix [group]              # Run tests and auto-fix failures
stably deploy                   # Deploy tests to cloud
stably open [file]              # Open in web platform

stably connect                  # Link project to Stably cloud
stably config init              # Create stably.config.yaml
stably config validate          # Validate configuration
stably auth login               # Authenticate with Stably
stably auth logout              # Remove authentication

stably list                     # List all test groups
stably status                   # Show recent test runs
stably logs [run-id]            # View test run logs
stably results [run-id]         # View detailed test results

# Run with custom reporter
npx stably test --reporter=html,json

# Run with environment variables
npx stably test --env=staging

# Run specific files
npx stably test --grep "checkout"

# Debug mode
npx stably test --debug --headed

# Dry run (validate without executing)
npx stably test --dry-run

# Open current test in web editor
npx stably open tests/checkout.spec.ts

# Open test results in dashboard
npx stably open --results

# Start recording in browser
npx stably record --web

# Clear and re-authenticate
npx stably auth logout
npx stably auth login

# Or use API key directly
export STABLY_API_KEY=stably_...

# stably.config.yaml
cloudRunner:
  env:
    BASE_URL: https://staging.example.com