# 0.2.0

Released 11 October 2026.

A flow step can be a goal an agent drives: your agent works it out once, and every run after that replays it without a model. Studio's Runtime Inspector shows each component's live props, hooks and state, maps your app's screens, and Replay opens on what went wrong. Squiggle also drives react-native-macos apps, and a login flow runs in about a quarter of the time it took in 0.1.0.

Two changes may need action. MCP tool names lose their `squiggle_` prefix, so update any permission grant that names a tool. A step key that nothing reads is now an error with its line number, so fix any typo it reports.

## Desktop app

- **New**: agentic flows: a step can be a goal an agent drives. Flows has Scripted and Agentic tabs, shows how many agent steps each flow has recorded, and edits an agent step's prompt, verifier and recording. Intent runs moved here too, replacing the Agents screen
- **New**: the Runtime Inspector: a component tree beside four views of the selection — Details, Graph, Perf and Screen map
- **New**: Inspector Details: a component's props, hooks and state, its context and stores, renders, accessibility, style and structure, read live from the app
- **New**: edit a prop or a hook's state from the Inspector and the app on the simulator changes with it, until it reloads
- **New**: pick a component by pointing at it on the device mirror; where several are stacked under the pointer, the scroll wheel walks through them and a click lists them all
- **New**: Follow in app: selecting a component in the tree or the graph brings it on screen, navigating to its screen and scrolling it into view
- **New**: open the line that writes an element, or where its component is defined, in your editor
- **New**: the Inspector's Graph draws the live component graph as a tree or a force layout, with pan, zoom and the lineage of whatever you hover
- **New**: the Screen map: your app's screens and the taps between them, drawn as a roadmap with each navigator's screens grouped under its name, the screen the app is on ringed, and every screen's picture
- **New**: Crawl the app from the Screen map: it presses each control in turn, maps every screen a press opens and photographs it, signing in with the values your flows type. Crawl from here starts on one screen, and the map fills in as it goes
- **New**: Go to screen: pick a screen from the map or the menu, and Go there drives the app along the known path to it
- **New**: from any screen on the map, start a scripted flow that taps its way there, or an agentic flow that starts there
- **New**: the Screen map shows which screens no flow reaches, filters to the screens reachable from where the app is, and adds the screens you open yourself
- **New**: Replay, redesigned around what went wrong: Studio keeps the five seconds before a crash, error, stall or spike as an incident, and the player opens on it with a screenshot and a report you can copy
- **New**: from an incident, explain the component it blames, open the run in Performance or Analytics, or make a regression flow from it
- **New**: Replay's event list says what was tapped, swiped or scrolled, where, and what it led to, and its timeline has metric lanes for frames, activity, memory and latency, each with a legend
- **New**: Drive device: scrubbing a recording, pressing an event or playing it drives the app on the simulator to the same moment
- **New**: recordings are named the way you would describe them, and you switch between them without leaving the player
- **New**: a gallery for screenshots and screen recordings, with a swipeable, zoomable viewer. Screen recordings are H.264 or HEVC video
- **New**: simulator tools and real device skins
- **New**: compact mode: a small simulator-only window with its own toolbar, which you customise and reorder, and a row of live graphs
- **New**: installing the app installs the `squiggle` command too: it links itself into your terminal, and offers to add it to your PATH when your shell cannot find it. Settings → Command line removes it
- **Fix**: Studio no longer runs out of memory while the device mirror streams
- **Fix**: clicks on a menu or tooltip land on it rather than the control underneath, overlays open beside their control, and buttons keep working after compact mode
- **Fix**: the simulator mirror takes input with no app connected, and an overlay over it no longer passes clicks through to the simulator
- **Fix**: re-running a flow from History uses the settings the run was recorded with
- **Fix**: the notification bell reports failed runs (flows, benches, crawls, recordings, agent runs) and stays quiet about a command you typed in a terminal, which already showed its error
- **Perf**: Studio's idle CPU dropped from 22% to 6% of a core, and the device mirror costs about 20 points of a core less
- **Perf**: flows run from Studio at the same speed as from the terminal
- **Perf**: a 2,000-node graph pans and zooms at 60 fps, and switching tree and force layouts takes a tenth of the time
- **Perf**: memory stays flat in a long session: an hour at 60 renders a second holds 11.6 MB instead of 90.7 MB, and a two-hour recording writes 130 MB instead of 968 MB
- **Perf**: Studio uses 43% less CPU while other tools read the app through it

## CLI

- **New**: drive react-native-macos apps as well as iOS: `--platform macos` on every device command, and `install-macos-agent.sh`, shipped beside the binary, puts the agent in your app
- **New**: `squiggle flow --record` saves the run as a video, and an agent can attach it to a pull request
- **New**: `squiggle probe` reads live values from the running app's JavaScript over Metro
- **New**: `squiggle crawl` writes screen memory as it goes, and `crawl --changed` revisits only the screens a change touches
- **New**: a failed step says why and what to do next, and `--log <level>` streams the run's events as it goes
- **New**: `squiggle init --agent claude|copilot|codex` registers the MCP server with the agent you use, for Claude Code, Copilot or Codex
- **New**: `squiggle bench --pr <N>` posts the result as a sticky comment on the pull request
- **Fix**: `scroll` no longer crashes the simulator, and it actually scrolls
- **Fix**: a tap on an element off screen is refused instead of landing on whatever is there
- **Fix**: back-to-back flow runs pass: no screens left open by the previous run, and each run starts from where its flow expects to
- **Fix**: a run that launched your app gives up on one that never connects, and says why
- **Fix**: `squiggle flows` takes flow files as well as directories, and `squiggle agent run <name>` finds a program by name
- **Fix**: a react-native-macos app is driven in the background, and an action that did nothing is reported as a failure rather than a success
- **Perf**: `squiggle --version` answers in about 20 ms

## Agents & MCP

- **Breaking**: tool names drop the `squiggle_` prefix your client already adds, so `mcp__squiggle__squiggle_tap` is now `mcp__squiggle__tap`. Update any permission grant that names a tool. `squiggle_exec` is now `probe_read`
- **New**: `run_flow` runs agentic flows: your agent drives each agent step once, and every run after that replays it without a model
- **New**: `filmstrip` reads a recording's frames, for defects the graph cannot see
- **New**: `describe` and `find` see native views, such as an Expo Router native tab bar, that `tap` could already reach
- **New**: an action returns the screen it just changed, so the next step needs no second look
- **New**: every tool has a display title in your client
- **New**: every element knows the line that writes it: `describe {fields: 'source'}` shows it, and `find {callSite}` shows what a line renders
- **New**: `inspect` reads a component's live props, hooks and state
- **Fix**: no tool call waits forever, and one that hangs no longer blocks the rest
- **Fix**: `input_text` waits for the field to take focus, so the tap after it lands
- **Fix**: Studio and the CLI take port 7777 back from an idle MCP server
- **Fix**: a flow's secrets never reach the model, the run report or the recording
- **Fix**: the agent kit's hooks and slash commands run your installed `squiggle`, and its `plugin.json` starts the server with `squiggle mcp`. The kit no longer carries a `Stop` hook that only applied to Squiggle's own repository. Regenerate the kit after upgrading
- **Perf**: a tap with its observation returns in 110–185 ms, and choosing the target takes 7 ms instead of 300
- **Perf**: `perf_sql` and saved queries answer within a 24 KB budget with a truncation note, instead of reading the whole table first

## Flows & device

- **Breaking**: a step key that nothing reads is a parse error with its line number. It used to be ignored, and surfaced later as a selector that would not match
- **New**: `agent:` steps: a goal an agent drives, checked by a verifier you write, recorded beside the flow as `.agent.json` and replayed from then on
- **New**: declared routes, with route hints for agent steps
- **New**: a flow can declare that it fails by design, or that it runs some other way
- **New**: a flow's `config:` block carries the run settings it needs (scroll mode, settle and step timing, `autoScroll`, `strictAssert`), so a suite runs every flow the way it was written to run
- **New**: a recorded tap names the control it pressed
- **Fix**: an app launched without the agent is relaunched with it before a run, instead of running slower without it
- **Fix**: "keep software keyboard: off" keeps it off, and a run never takes over another app on its device
- **Perf**: a login flow runs in about a quarter of the time: the median went from 10.9 s at 0.1.0 to 2.7 s, and 2.3 s with `--direct-scroll`
- **Perf**: `squiggle flow` starts about 1.4 s sooner, and reconnects after a relaunch in 1.0 s instead of 6.2 s
- **Perf**: a suite spends less time resetting between flows, and its shards pull from one queue ordered by each flow's last duration

## Performance

- **New**: what Studio derives live (dead zones, scrolls, gesture tracks, the touch heatmap) is stored in `perf.db`, so your agent can query it
- **Perf**: the metric store keeps older samples at coarser resolution, so a store that had grown to 1.5 GB now takes about 30 MB. Product reads take under 2 ms, and writes are 4× cheaper

## SDK

- **New**: Legend State stores are instrumented by the Babel plugin, alongside Zustand, MMKV, AsyncStorage and SQLite
- **Perf**: the SDK does less work on your app's JavaScript thread, and sends about 31% fewer bytes per frame. Encoding a frame takes 122 ns instead of 360, and an app nobody connects to no longer holds 2.3 MB of memory for it

## Website

- **New**: try Studio in your browser at squiggle.sh/studio, against a live demo app, with a guided tour of 21 chapters across every screen
- **New**: docs pages open on live slices of it, and every page's header opens Studio over the page you are on
- **New**: on a phone, Studio plays its own tour, sized to read, with a chapter menu

## Everything else

- **Perf**: a crawl of the example app's 18 screens takes 46 s instead of 94 s, and never leaves the app
- **Perf**: checking the assertions of 421 recordings takes 3.9 s instead of 209 s, and seeking a recording is about 3.4× faster
