Reference

Compatibility

This page describes saffron-ai 1.3.4. It is generated from the release's own code and lockfile, so it names what this version accepts and what its test suite ran on. Run npx saffron --version to see which version a project uses: a combination outside this page is unsupported, and a failure there may not be your app's.

Runner

Supported Tested with
Node.js >=22.12 22 (CI)
Operating systems macOS, Linux, Windows ubuntu-latest (CI), macOS (development)
Playwright ^1.63.0 1.64.0
Browsers Chromium, Chrome and Edge record and replay; Firefox and WebKit replay chromium, firefox, webkit (CI)
Recording format reads versions 1 to 19, writes the lowest version a recording needs 19

A recording written by a newer saffron-ai than the one reading it is refused by name ("Update saffron-ai to the release that wrote it"), never replayed wrong.

AI providers

Provider What it needs Supported Tested with
Claude @anthropic-ai/claude-agent-sdk, a dependency of saffron-ai ^0.3.198 0.3.296
Codex @openai/codex-sdk, installed by the project >=0.158.0 0.158.0
Cursor @cursor/sdk, installed by the project ^1.0.32 1.2.0
Antigravity (experimental) the agy command on PATH any version that signs in not pinned

The browser tools every provider drives come from @playwright/mcp ^0.0.77 (tested with 0.0.77).