# 0.6.8

Released 18 November 2026.

Fixes for 0.6.7. You can take a screenshot from the CLI or as a flow step, check a colour on screen, and run a flow on an app without the JS SDK. Flows can clear an app's data on the iOS simulator and restore a save slot, send the app to the background, post audio-session events and turn on Reduce Motion or Reduce Transparency. Each project and each checkout keeps to its own app, Metro, simulator and port: Studio, another project's agent or another worktree no longer takes, names or acts on your app. A busy screen's graph keeps up with the screen and repairs itself after lost events, and Studio no longer grows to gigabytes over a long session or stalls under a heavy event stream.

Some behaviour changed. Studio's relay serves an app only to a `squiggle` command or agent whose project owns it (lists its bundle id under `apps` in `.squiggle/config.jsonc`, or built its development bundle in the project folder); an older `squiggle` command is refused, so update it with `npm install -g @squiggle.sh/cli@latest` (or update Studio if you use the command that comes with it) and restart any `squiggle mcp` server. MCP tools refuse arguments they don't take instead of ignoring them. `--strict-assert` fails a run when a passing `assert` step holds a pending or unsupported assertion. A tap on a target that is covered whole is refused with `target_covered`. Healing never moves a step onto a sibling row (`row-4` for `row-45`). The default swipe takes 200 ms instead of 300 ms. `setPermissions` ends a running app before a change iOS would end it for and relaunches it, and skips a change that already holds. `squiggle card` refuses a file that isn't in the repository (`E_CARD_FILES_MISSING`) and a scope with nothing to check (`E_CARD_NOTHING_TO_CHECK`). An app launched on its own port, or with one in its bundle, connects to that port alone and joins only its own project's Squiggle. Squiggle never uses a Metro of another checkout or one that names no project folder, and never picks a simulator another checkout's config names or another project's agent drives unless you name it. Node text is read up to 2,000 characters instead of 80, and a render count includes the first re-render after mount, so counts can be one higher than before.

## Desktop app

- **Fix**: Studio's memory no longer grows with every app reload or relaunch (several GB after a day)
- **Fix**: the device relay keeps forwarding under a heavy event stream, and listens again after a Metro reload
- **Fix**: Studio stays off a simulator another checkout or another project's agent uses unless you pick it, and its device panel says when every booted simulator is in use elsewhere
- **Fix**: a flow's taps are never saved as rage taps, whichever command ran it (`squiggle card`, `bench`, an MCP call)
- **Fix**: a refused `squiggle update` request logs why

## Agents & MCP

- **New**: `describe`, `find`, `logs`, `assert` and `screenshot { sample }` take `udid` to read another simulator without driving it or moving the session
- **New**: `logs { source: 'native' }` and `squiggle logs --source native [--system]` show the app's `NSLog` and other native log lines
- **New**: `report_card` takes `root`, so it cards a worktree's changes; without it, it runs in the checkout that owns the app
- **New**: `launch_app { fresh: true }` relaunches the app (as `relaunch: 'always'` does) and always says whether it relaunched and on which Metro
- **New**: when the installed CLI is updated under a running MCP server, every tool result says once to restart it, and `status.server` reports both versions

## Performance

- **New**: memory is sampled through every step and on every screen change, so `memoryDelta` judges the app's footprint over a long `repeat`
- **New**: footprint by category (`Malloc`, `Untagged VM`, …) appears in `perf report`, `perf budget` and the report card's `memoryCeilingMb` row; `SQUIGGLE_MEMORY_BREAKDOWN_S=0` turns it off
- **New**: the worklet UI runtime's heap is recorded as `WorkletUiHeapBytes`, and `perf heap --ui` / `perf_heap { runtime: 'ui' }` snapshots it; audio worklet runtimes are not measured
- **New**: `perf heapdiff` shows the shortest path from the GC roots to each growing type, and `--name` (MCP `name`) traces a type that isn't the biggest grower
- **Fix**: `perf heap` and `perf profile` take the app you name or are attached to, not the store's newest session
- **Fix**: your Metro's own requests are no longer counted as your app's network traffic
- **Fix**: a render count no longer misses the first re-render, and an app relaunched within a step counts its renders afresh

## Everything else

- **New**: `squiggle screenshot [name] [--udid] [--source] [-o]` saves a screenshot of a simulator, a `mac:` app or a `web:` tab into `.squiggle/screenshots/`
- **New**: the `screenshot: <name>` flow and intent step works on every target (`takeScreenshot` is its alias)
- **New**: screenshots keep the app's own colour profile (16-bit Display P3) when the app is in front with no keyboard or alert over it, and fall back to the simulator's screen otherwise
- **New**: MCP `screenshot` takes `udid` to shoot another simulator without moving the session, and says when the shot was taken (`takenAt`, and the step it fell in during a background `run_flow`)
- **New**: `assert: { color: { of | backgroundOf | at, is, tolerance, wideGamut, luminance } }` and MCP `screenshot { sample }` read a colour off the screen, and wait up to 2 s for it to settle; an iOS simulator draws in sRGB, so `wideGamut: true` there fails and says to check on a Mac app
- **New**: `launchApp: { clearState: true }` works on the iOS simulator: it empties the app's data and resets its privacy settings, keeping the keychain, app groups and your save slots
- **New**: `loadSlot: <name>` restores a save slot from `squiggle save` or the MCP `fixture` tool inside a flow
- **New**: `background: { ms }` (flow step, MCP `device { background }`) sends the app home and brings it back, and fails if iOS ended it meanwhile
- **New**: `audioSession: { interruption: began | ended, shouldResume }` or `{ routeChange: <reason> }` posts the notification iOS sends your app
- **New**: `reduceMotion: true|false` and `reduceTransparency: true|false` flow steps, `squiggle device reduce-motion|reduce-transparency on|off` and MCP `device { reduceMotion, reduceTransparency }`; a running app's `AccessibilityInfo` listener sees the change
- **New**: `squiggle flow <flow> --native-only` runs a flow on an app without the JS SDK, through accessibility and simulator input, including `screenshot:` and colour asserts; a step it can't run is refused before the run with `E_NATIVE_ONLY`
- **New**: a drag leg takes `assert`, checked during its `pause` while the finger is still down
- **New**: `textMatches` and `textNumber` on a control with no text of its own read the texts inside it
- **New**: `legibleContrast: { text: true }` judges the contrast of every displayed text, and `legibleContrast: { within: <selector> }` judges the text and controls inside one element
- **New**: `squiggle card --accept-renders` (or `report_card { acceptRenders: true }`) accepts render growth you reviewed; render growth is compared launch with launch, and its baseline moves forward once a run's render rows pass
- **New**: `squiggle update` works when the CLI ships inside Studio: it updates Studio, launching it in the background if needed, and prints the new version
- **New**: `squiggle up --metro <url|port>` opens the development build on that Metro
- **Fix**: each worktree uses its own Metro, simulator and port: a scan never picks another checkout's Metro, a relaunch moves the app off one, and `doctor --quick` fails a `checkouts` row when a session of one checkout drives another's simulator
- **Fix**: an app launched on its own port no longer also connects to Studio's :7777, including after a `flow --race` or `doctor --fix` relaunch
- **Fix**: `status`, `target`, `launch_app`, held-device errors and `doctor` name only apps your project owns; another project's app reads "an app this project doesn't own"
- **Fix**: your agent never closes a dev menu or accepts an "Open in" alert that belongs to another project's app
- **Fix**: a worktree's own MCP session no longer holds its app against that worktree's CLI (`E_DEVICE_HELD`)
- **Fix**: a run takes its app back when the same app reconnects after its connection closed, and a disconnect names only a Squiggle the app was connected to
- **Fix**: `setPermissions` no longer passes and leaves the app to be ended by iOS a moment later, which failed the next step
- **Fix**: `squiggle mcp` no longer writes warnings to stdout, where your agent's client read them as broken lines
- **Fix**: `flow --matrix`, `--predict` and `--breakpoints` use the run's simulator, not the first one booted
- **Fix**: a run waiting on a Studio that serves another simulator says so once, not on every retry
- **Fix**: text past 80 characters or 8 parts is read, and a text cut at 2,000 characters is marked `textTruncated`; `text:` and `textMatches` match on its prefix and a miss says it was cut
- **Fix**: after lost events the graph rebuilds itself and reads `stale` until it has; a repair no longer leaves ghost nodes or `<unknown:N>` names, and on iOS a consumer that falls behind is caught up instead of left minutes behind
- **Fix**: a window-overlay sheet or modal opened from a pager page is in the graph at its real position, and a `visible` miss says why (covered, on a page the pager doesn't show, or a stale graph)
- **Fix**: `evidence.eventId` starts again after a relaunch, and a fresh session cites the newest event
- **Fix**: a list of about 17,000 items or a very deep tree no longer loses the end of the graph, and `tag` / `identify` data nested past 32 levels or circular is cut (`[nested too deep]`, `[circular]`) instead of dropped
- **Fix**: `checked:` and `selected:` read `accessibilityState` and `aria-*` on React Native, including through a wrapper with the testID
- **Fix**: `notVisible` passes on a component that draws nothing, and `visible` fails on it saying so
- **Fix**: an uncontrolled input that can't be read as a text field reports what it reads instead of "cannot read that view"
- **Fix**: a tap on a partly covered target (a scrim behind a card) aims at the part that shows
- **Fix**: a tap whose screen reacts late (Appearance) or repaints off React under the finger is no longer failed as `no_reaction`
- **Fix**: `scrollUntilVisible` and `autoScroll` reach rows below a bottom sheet's fold
- **Fix**: a swipe keeps its speed to the lift, so a bottom sheet moves to the next detent
- **Fix**: `legibleContrast` and `noBlankFrame` say whether controls were unmeasured or missed by accessibility instead of "on other screens", `noBlankFrame` reads a screen's text when it has no controls, and the checks under a sheet take a fraction of the time
- **Fix**: legibility no longer flags Gesture Handler 3's `LeanReanimatedNativeDetector`, or the face inside a labelled icon button
- **Fix**: a component the last green run never rendered is a warning ("no baseline yet"), and growth at launch fails as "at launch"
- **Fix**: a release build with the SDK installed from npm and `EXPO_PUBLIC_SQUIGGLE_ALLOW_RELEASE=1` connects (Expo 58)
- **Fix**: a release build that never connects is not relaunched on a Metro, and the run says what is missing (the SDK, the native library or the opt-in)
- **Fix**: when your app's JS failed to load, the run quotes the red box and Metro's error instead of blaming a port
- **Fix**: a flow's `stopApp` no longer quits the browser `squiggle up` holds
- **Fix**: `smooth` counts only frames dropped while the motion runs, and web taps no longer wait out Squiggle's own frame loops
