All releases - Playmatic Documentation

September 22, 2025

CLI v0.1.15 - Automatic Localhost Tunneling

🔄 Smart Tunneling EnhancementCLI v0.1.15:

Automatic localhost detection: CLI now automatically detects localhost URLs in your configuration and creates tunnels without requiring the --local flag
Simplified workflow: No manual flag needed - just run playmatic run and localhost URLs are tunneled automatically
Seamless local development: Zero-configuration tunneling for any localhost-based environment setup

What’s New: When your environment configuration contains localhost URLs (like http://localhost:3000), Playmatic automatically creates secure HTTPS tunnels without needing the --local flag. This streamlines local development testing by removing an extra step from your workflow.

September 22, 2025

CLI v0.1.14 - Enhanced Execution Speed & Reasoning

🚀 Performance & UX ImprovementsCLI v0.1.14:

Optimized execution speed: Refined computer action delays for faster, more reliable test execution
Enhanced reasoning visibility: Improved logging and output to better understand agent decision-making

What’s New: Agent execution is now faster and more transparent, with optimized delays between actions and better visibility into the reasoning process. These improvements result in more efficient test runs while maintaining reliability.

September 16, 2025

CLI v0.1.9 - CI Notifications & Team Collaboration

🔔 Major Feature: Automated CI NotificationsCLI v0.1.9:

Smart CI notifications: Automatic Slack notifications for GitHub Actions test runs
Rich context: Includes repository, branch, commit, and workflow information in notifications
Team-aware: Respects existing team notification preferences (all results vs issues only)
Multi-channel delivery: Sends notifications to all Slack channels where your bot is invited
GitHub integration: Full GitHub metadata captured in CI environments

What’s New: When your tests run in GitHub Actions, team members now receive rich Slack notifications with test results, GitHub context, and direct links to view detailed results. Configure once, get notifications across all your team’s Slack channels automatically.

September 13, 2025

CLI v0.1.8 - GitHub Actions Integration

🚀 Major Feature: GitHub Actions CI IntegrationCLI v0.1.8:

Automated CI setup: New playmatic ci-setup command for instant GitHub Actions integration
GitHub Action v1.0.0: Local CLI execution with environment support
One-command setup: From zero to CI in under 1 minute

What’s New: Run playmatic ci-setup to automatically create GitHub Actions workflows, generate CI API keys, and get direct links to configure secrets. Your Playmatic tests can now run seamlessly in GitHub Actions with full video recording support.

September 12, 2025

CLI v0.1.3 - Improved Execution & Output

CLI v0.1.3:

Video recordings: View complete video recordings of your test sessions after completion
Smooth exit handling: Ctrl+C now works reliably with proper cleanup
Better parallelization: Improved performance for concurrent test execution
Enhanced output: Computer use reasoning logs now visible during test execution

September 11, 2025

CLI v0.1.2 - Configuration & Sample Updates

CLI v0.1.2:

Optimized default timeout: Reduced default actionTimeout from 15s to 10s for faster test execution
Cleaner sample configuration: Removed sampleEnv complexity in generated config
Better environment guidance: Added documentation links and clearer comments in generated config
Simplified sample test: Uses hardcoded URL for immediate testing without environment setup

What’s New: The generated configuration is now cleaner and more educational, with practical staging/production examples and better guidance on customizing environments for your application.

September 11, 2025

CLI v0.1.1 - Improved Setup Experience

CLI v0.1.1:

Simplified setup: Default environment now set to sampleEnv for immediate playmatic run usage
Better onboarding: New users can run tests instantly without environment flags
Clear migration path: Added helpful comments in generated config for transitioning to development environment
Streamlined CLI output: Simplified setup success messages

What’s New: After running playmatic setup, you can now immediately run tests with just playmatic run - no need to specify environments for the sample test. The generated config includes clear guidance on customizing environments for your own application.

September 10, 2025

v0.1.0 - Breaking Changes & Environment Management

🎉 Major Release: Playmatic CLI & SDK v0.1.0⚠️ Breaking Changes - See migration guideCLI v0.1.0:

TypeScript configuration: Support for playmatic.config.ts files
Environment switching: New --env flag for easy environment management
Local development tunneling: New --local flag for automatic tunnel creation
Updated setup command: Generates TypeScript config files by default

SDK v0.1.0:

New test signature: Test functions now require ({ env }) => {} parameter
Environment-based configuration: Access env.baseUrl and env.vars.* in tests
Computer use agent visibility: All environment variables automatically available during healing
Centralized config management: Define environments in TypeScript config files

🔗 Local Development Tunneling: The new --local flag makes testing localhost applications effortless:

Zero configuration: No accounts, API keys, or setup required
Automatic tunneling: Instantly creates secure HTTPS tunnels for local apps
DNS handling: Built-in DNS propagation wait for reliable connectivity
Environment integration: Works seamlessly with the new environment system

# Auto-tunnel your local development environment
playmatic run --env development --local

// Example config - localhost URLs work automatically with --local
env: {
  development: {
    baseUrl: "http://localhost:3000", // Tunneled automatically
    vars: { API_KEY: process.env.DEV_API_KEY }
  }
}

Migration Required: Existing tests need updates. See our complete migration guide.

September 9, 2025

CLI v0.0.15 - Config Command & Validation

CLI Improvements:

Separate config command: Added dedicated playmatic config command
Enhanced validation: Better 4xx response handling and error messages
App URL improvements: Refined prompts for application URL configuration

September 8, 2025

CLI v0.0.14 & SDK v0.0.7 - Goal-based Tests

CLI v0.0.14:

Improved prompts: Renamed app URL prompt for better clarity

SDK v0.0.7:

Test structure update: Changed from “name” to “goal” for better test organization
Consistency improvements: Aligned terminology across CLI and SDK

September 7, 2025

CLI v0.0.13 & SDK v0.0.6 - Playwright Optimizations

CLI v0.0.13:

Test structure: Updated to use “goal” instead of “name” for clearer test definitions

SDK v0.0.6:

Removed expect: Cleaned up unnecessary Playwright expect import
Performance improvements: Optimized SDK bundle size

September 6, 2025

CLI v0.0.12 & SDK v0.0.5 - Performance Enhancements

CLI v0.0.12:

Optimization: Removed unnecessary calls to pageTitle and currentUrl
Faster execution: Improved test runner performance

SDK v0.0.5:

Import cleanup: Removed unnecessary Playwright imports
Bundle optimization: Reduced SDK footprint

September 5, 2025

CLI v0.0.11 & SDK v0.0.4 - Precompile & Playwright Integration

CLI v0.0.11:

Precompile support: Added precompilation for faster test execution
Build improvements: Enhanced TypeScript compilation process

SDK v0.0.4:

Playwright integration: Added expect, browser, and context from Playwright
Enhanced testing capabilities: Better integration with Playwright test utilities

September 4, 2025

CLI v0.0.10 & SDK v0.0.3 - Sample Tests & Type Safety

CLI v0.0.10:

Updated sample test: Improved default test examples and templates
Better onboarding: Enhanced setup experience for new users

SDK v0.0.3:

TestStepOptions: Added proper TypeScript interfaces for test step options
Type safety: Improved IntelliSense and development experience

September 3, 2025

CLI v0.0.9 - Stability & UX Improvements

CLI v0.0.9:

Crash prevention: Fixed invalid page states that could cause crashes
Improved output display: Better formatting and error reporting
Enhanced messaging: Clearer user communication throughout test execution

September 2, 2025

CLI v0.0.8 & SDK v0.0.2 - Initial SDK Release

CLI v0.0.8:

Enhanced output: Improved test execution output and logging
Better visibility: More detailed progress reporting

SDK v0.0.2:

Initial public release: Core test and testStep functions for defining E2E tests
Playwright support: Both Playwright code and natural language test steps
Function overloads: Optional execute functions for flexible test definitions
TypeScript support: Full type definitions and IntelliSense

August 31, 2025

CLI v0.0.7 - Configuration & Samples

CLI v0.0.7:

App URL configuration: Added appUrl to config file for easier setup
Config management: Streamlined configuration file handling
SDK integration: Updated to latest @playmatic/sdk

August 30, 2025

CLI v0.0.5-6 - Setup & Cache Improvements

CLI v0.0.6:

SDK updates: Updated to latest @playmatic/sdk version
Compatibility: Improved integration between CLI and SDK

CLI v0.0.5:

Enhanced setup: Added configuration management and sample tests during setup
Better onboarding: Streamlined initial user experience
Sample tests: Included example tests to get started quickly

August 29, 2025

CLI v0.0.4 - Cache Functions

CLI v0.0.4:

Playwright cache variables: Added more Playwright variables for improved cache function performance
Better caching: Enhanced test step caching with additional context

Docs Improvements:

Using AI tools: AI coding agents section has been turned into Claude & Cursor specific guides
Playwright clarity: Clarified that the Playwright code is optional & users do not have to install the Playwright package for cached actions
Bug fixes: Improved tips & notes in various sections to better guide readers

August 28, 2025

Closed Beta Launch

CLI v0.0.3:

API authentication: Added API auth on endpoints for secure communication
Code cleanup: Removed unused code and improved performance
Security: Enhanced authentication handling

We’re excited to announce the closed beta release of the Playmatic CLI for local development!New Features:

Self-healing tests: Playmatic tests are self-healing using natural language and cache functions with Playwright-compatible code
Generate tests: Generate tests using natural language with the AI composer
Run tests locally: Run Playmatic tests directly from your development machine
Parallel execution: Run multiple tests simultaneously for faster feedback
Documentation: Read the documentation to get started quickly and understand our framework

RELEASE NOTES