> ## Documentation Index
> Fetch the complete documentation index at: https://docs.playmatic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# All releases

> Stay updated with the latest Playmatic releases, features, and improvements

<Update label="September 22, 2025" description="CLI v0.1.15 - Automatic Localhost Tunneling">
  **🔄 Smart Tunneling Enhancement**

  **CLI 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.
</Update>

<Update label="September 22, 2025" description="CLI v0.1.14 - Enhanced Execution Speed & Reasoning">
  **🚀 Performance & UX Improvements**

  **CLI 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.
</Update>

<Update label="September 16, 2025" description="CLI v0.1.9 - CI Notifications & Team Collaboration">
  **🔔 Major Feature: Automated CI Notifications**

  **CLI 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.
</Update>

<Update label="September 13, 2025" description="CLI v0.1.8 - GitHub Actions Integration">
  **🚀 Major Feature: GitHub Actions CI Integration**

  **CLI 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.
</Update>

<Update label="September 12, 2025" description="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
</Update>

<Update label="September 11, 2025" description="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.
</Update>

<Update label="September 11, 2025" description="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.
</Update>

<Update label="September 10, 2025" description="v0.1.0 - Breaking Changes & Environment Management">
  **🎉 Major Release: Playmatic CLI & SDK v0.1.0**

  **⚠️ Breaking Changes** - [See migration guide](/release-notes/migration-v0.1.0)

  **CLI 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

  ```bash theme={null}
  # Auto-tunnel your local development environment
  playmatic run --env development --local
  ```

  ```typescript theme={null}
  // 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](/release-notes/migration-v0.1.0).
</Update>

<Update label="September 9, 2025" description="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
</Update>

<Update label="September 8, 2025" description="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
</Update>

<Update label="September 7, 2025" description="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
</Update>

<Update label="September 6, 2025" description="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
</Update>

<Update label="September 5, 2025" description="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
</Update>

<Update label="September 4, 2025" description="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
</Update>

<Update label="September 3, 2025" description="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
</Update>

<Update label="September 2, 2025" description="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
</Update>

<Update label="August 31, 2025" description="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`
</Update>

<Update label="August 30, 2025" description="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
</Update>

<Update label="August 29, 2025" description="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
</Update>

<Update label="August 28, 2025" description="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
</Update>