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 updaterequest logs why
Agents & MCP
- New
describe,find,logs,assertandscreenshot { sample }takeudidto read another simulator without driving it or moving the session - New
logs { source: 'native' }andsquiggle logs --source native [--system]show the app'sNSLogand other native log lines - New
report_cardtakesroot, 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 (asrelaunch: '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.serverreports both versions
Performance
- Newmemory is sampled through every step and on every screen change, so
memoryDeltajudges the app's footprint over a longrepeat - Newfootprint by category (
Malloc,Untagged VM, …) appears inperf report,perf budgetand the report card'smemoryCeilingMbrow;SQUIGGLE_MEMORY_BREAKDOWN_S=0turns it off - Newthe worklet UI runtime's heap is recorded as
WorkletUiHeapBytes, andperf heap --ui/perf_heap { runtime: 'ui' }snapshots it; audio worklet runtimes are not measured - New
perf heapdiffshows the shortest path from the GC roots to each growing type, and--name(MCPname) traces a type that isn't the biggest grower - Fix
perf heapandperf profiletake 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
- New
squiggle screenshot [name] [--udid] [--source] [-o]saves a screenshot of a simulator, amac:app or aweb:tab into.squiggle/screenshots/ - Newthe
screenshot: <name>flow and intent step works on every target (takeScreenshotis 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
screenshottakesudidto shoot another simulator without moving the session, and says when the shot was taken (takenAt, and the step it fell in during a backgroundrun_flow) - New
assert: { color: { of | backgroundOf | at, is, tolerance, wideGamut, luminance } }and MCPscreenshot { sample }read a colour off the screen, and wait up to 2 s for it to settle; an iOS simulator draws in sRGB, sowideGamut: truethere 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 fromsquiggle saveor the MCPfixturetool inside a flow - New
background: { ms }(flow step, MCPdevice { 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|falseandreduceTransparency: true|falseflow steps,squiggle device reduce-motion|reduce-transparency on|offand MCPdevice { reduceMotion, reduceTransparency }; a running app'sAccessibilityInfolistener sees the change - New
squiggle flow <flow> --native-onlyruns a flow on an app without the JS SDK, through accessibility and simulator input, includingscreenshot:and colour asserts; a step it can't run is refused before the run withE_NATIVE_ONLY - Newa drag leg takes
assert, checked during itspausewhile the finger is still down - New
textMatchesandtextNumberon a control with no text of its own read the texts inside it - New
legibleContrast: { text: true }judges the contrast of every displayed text, andlegibleContrast: { within: <selector> }judges the text and controls inside one element - New
squiggle card --accept-renders(orreport_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 updateworks 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 - 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 --quickfails acheckoutsrow 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 --raceordoctor --fixrelaunch - Fix
status,target,launch_app, held-device errors anddoctorname 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
- Fix
setPermissionsno longer passes and leaves the app to be ended by iOS a moment later, which failed the next step - Fix
squiggle mcpno longer writes warnings to stdout, where your agent's client read them as broken lines - Fix
flow --matrix,--predictand--breakpointsuse 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:andtextMatchesmatch on its prefix and a miss says it was cut - Fixafter lost events the graph rebuilds itself and reads
staleuntil 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
visiblemiss says why (covered, on a page the pager doesn't show, or a stale graph) - Fix
evidence.eventIdstarts 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/identifydata nested past 32 levels or circular is cut ([nested too deep],[circular]) instead of dropped - Fix
checked:andselected:readaccessibilityStateandaria-*on React Native, including through a wrapper with the testID - Fix
notVisiblepasses on a component that draws nothing, andvisiblefails 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 - Fix
scrollUntilVisibleandautoScrollreach rows below a bottom sheet's fold - Fixa swipe keeps its speed to the lift, so a bottom sheet moves to the next detent
- Fix
legibleContrastandnoBlankFramesay whether controls were unmeasured or missed by accessibility instead of "on other screens",noBlankFramereads 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=1connects (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
stopAppno longer quits the browsersquiggle upholds - Fix
smoothcounts only frames dropped while the motion runs, and web taps no longer wait out Squiggle's own frame loops