ChangelogScreenshots and colour checks, device controls, and one project per app

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

  • FixStudio's memory no longer grows with every app reload or relaunch (several GB after a day)
  • Fixthe device relay keeps forwarding under a heavy event stream, and listens again after a Metro reload
  • FixStudio 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
  • Fixa flow's taps are never saved as rage taps, whichever command ran it (squiggle card, bench, an MCP call)
  • Fixa refused squiggle update request logs why

Agents & MCP

  • Newdescribe, find, logs, assert and screenshot { sample } take udid to read another simulator without driving it or moving the session
  • Newlogs { source: 'native' } and squiggle logs --source native [--system] show the app's NSLog and other native log lines
  • Newreport_card takes root, so it cards a worktree's changes; without it, it runs in the checkout that owns the app
  • Newlaunch_app { fresh: true } relaunches the app (as relaunch: 'always' does) and always says whether it relaunched and on which Metro
  • Newwhen 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

  • Newmemory is sampled through every step and on every screen change, so memoryDelta judges the app's footprint over a long repeat
  • Newfootprint 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
  • Newthe 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
  • Newperf 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
  • Fixperf heap and perf profile take the app you name or are attached to, not the store's newest session
  • Fixyour Metro's own requests are no longer counted as your app's network traffic
  • Fixa render count no longer misses the first re-render, and an app relaunched within a step counts its renders afresh

Everything else

  • Newsquiggle screenshot [name] [--udid] [--source] [-o] saves a screenshot of a simulator, a mac: app or a web: tab into .squiggle/screenshots/
  • Newthe screenshot: <name> flow and intent step works on every target (takeScreenshot is its alias)
  • Newscreenshots 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
  • NewMCP 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)
  • Newassert: { 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
  • NewlaunchApp: { 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
  • NewloadSlot: <name> restores a save slot from squiggle save or the MCP fixture tool inside a flow
  • Newbackground: { ms } (flow step, MCP device { background }) sends the app home and brings it back, and fails if iOS ended it meanwhile
  • NewaudioSession: { interruption: began | ended, shouldResume } or { routeChange: <reason> } posts the notification iOS sends your app
  • NewreduceMotion: 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
  • Newsquiggle 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
  • Newa drag leg takes assert, checked during its pause while the finger is still down
  • NewtextMatches and textNumber on a control with no text of its own read the texts inside it
  • NewlegibleContrast: { text: true } judges the contrast of every displayed text, and legibleContrast: { within: <selector> } judges the text and controls inside one element
  • Newsquiggle 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
  • Newsquiggle update works when the CLI ships inside Studio: it updates Studio, launching it in the background if needed, and prints the new version
  • Newsquiggle up --metro <url|port> opens the development build on that Metro
  • Fixeach 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
  • Fixan app launched on its own port no longer also connects to Studio's :7777, including after a flow --race or doctor --fix relaunch
  • Fixstatus, 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"
  • Fixyour agent never closes a dev menu or accepts an "Open in" alert that belongs to another project's app
  • Fixa worktree's own MCP session no longer holds its app against that worktree's CLI (E_DEVICE_HELD)
  • Fixa 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
  • FixsetPermissions no longer passes and leaves the app to be ended by iOS a moment later, which failed the next step
  • Fixsquiggle mcp no longer writes warnings to stdout, where your agent's client read them as broken lines
  • Fixflow --matrix, --predict and --breakpoints use the run's simulator, not the first one booted
  • Fixa run waiting on a Studio that serves another simulator says so once, not on every retry
  • Fixtext 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
  • Fixafter 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
  • Fixa 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)
  • Fixevidence.eventId starts again after a relaunch, and a fresh session cites the newest event
  • Fixa 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
  • Fixchecked: and selected: read accessibilityState and aria-* on React Native, including through a wrapper with the testID
  • FixnotVisible passes on a component that draws nothing, and visible fails on it saying so
  • Fixan uncontrolled input that can't be read as a text field reports what it reads instead of "cannot read that view"
  • Fixa tap on a partly covered target (a scrim behind a card) aims at the part that shows
  • Fixa tap whose screen reacts late (Appearance) or repaints off React under the finger is no longer failed as no_reaction
  • FixscrollUntilVisible and autoScroll reach rows below a bottom sheet's fold
  • Fixa swipe keeps its speed to the lift, so a bottom sheet moves to the next detent
  • FixlegibleContrast 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
  • Fixlegibility no longer flags Gesture Handler 3's LeanReanimatedNativeDetector, or the face inside a labelled icon button
  • Fixa component the last green run never rendered is a warning ("no baseline yet"), and growth at launch fails as "at launch"
  • Fixa release build with the SDK installed from npm and EXPO_PUBLIC_SQUIGGLE_ALLOW_RELEASE=1 connects (Expo 58)
  • Fixa 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)
  • Fixwhen your app's JS failed to load, the run quotes the red box and Metro's error instead of blaming a port
  • Fixa flow's stopApp no longer quits the browser squiggle up holds
  • Fixsmooth counts only frames dropped while the motion runs, and web taps no longer wait out Squiggle's own frame loops