CozyClay

A patch that makes the numbers readable: hosted builds report their version, and the export funnel and agent failures can be split by cause; plus a script-driven tutorial recorder.

Studio

• The Update chip now agrees across open Studio tabs at once: closing it, pressing Update now or an install finishing in one tab shows in the others without waiting for their next check.
• Help › About shows the version you are running.
• In Sculpt mode, click a part of the sculpt to select it: the part gets an outline, and its row lights up in the new Parts tree in the Sculpt panel. A click on a mirrored copy selects the part it mirrors. A click on empty space, or Esc, clears it.
• Sculpt shelf. Save to shelf in Sculpt mode keeps a sculpt as a card in Content › Sculpts, with a thumbnail. Drag a card into any scene of any project to place a copy. Export a card as .cozysculpt.json and import it on another machine.
• After a one-click update, Restart now starts the new version on the same port in the same terminal (macOS and Linux), and the Studio reloads when it answers. A project with unsaved changes asks you to save, then reload. Windows keeps the copy command by design.
• A selected sculpt part gets a gizmo: W moves it, E rotates it and R scales it (Shift scales evenly), and W/E/R go back to the turntable views once the part is cleared. One drag is one undo, a mirrored pair moves together, and an edit the recipe refuses snaps back with the reason. Delete with a part selected no longer deletes the whole sculpt.
• A capsule figure set to Sit now sits on the floor in an L, with its legs reaching forward the way it faces, instead of only getting shorter. Its bounds, and so framing, follow the new shape. (#999)

CLI

• cclay update --off turns the update line and the Studio's Update chip off for good; cclay update --on turns them back on. cclay update --check still answers either way.

Agent

• A task that read a whole character is told when another task edits one of that character's layers, so a placement built on an old position is flagged on its next step. (#981, #982)
• Task mode in the agent panel is on by default. Turning it off is remembered in this browser. (#998)

Sculpt

• Multi-view compare. The blueprint sheet is cropped into front, side, back and top views, each with its own mask; a view whose mask fails is dropped with a notice. sculpt.compare takes views: [{ yaw, reference, weight }] and weighs front, side and back 0.6, 0.25 and 0.15, giving 0 to a view whose proportions differ from the front by more than 35%. Start compares against the cropped side and back next to the front reference. Generate blueprint shows only with a ChatGPT sign-in. (#970, #995)

Analytics

• Hosted builds report the version they run. (#989)
• Opening the Export menu is counted, with whether the browser can encode MP4, so the export funnel can be read. The privacy page lists the new export:menu_opened event. (#990)
• Agent failures say whether the provider failed, the request got no network answer, or the cause is unknown, instead of one catch-all. (#991)
• MCP tool events carry the tool name, and studio_commands counts as a read. The privacy page lists the tool_name property. (#994)
• Reference exports made by QA scripts no longer count as user export attempts. (#993)
• Usage analytics no longer switch themselves off in source checkouts, forks or CI (a CI variable alone does not disable them), and the browser's Do-Not-Track setting is no longer read. Turn them off with cclay telemetry off, COZYCLAY_TELEMETRY=0 or DO_NOT_TRACK=1; the analytics toggle in Preferences and the launch notice are gone. An unreadable state file now reads as the defaults, with analytics on, and a Studio served on a local network address counts as local. The star question is asked once per version when the Studio starts, instead

Motion gets physics you can see and trust: props swing and settle after the hand stops, balance and jumps are judged by real mass and gravity and the Studio draws why, and characters no longer pass through each other when you drag or compile.

Studio

• Physics overlay. Tick Physics in the motion controls, or call motion.physicsOverlay, to draw the centre of mass (green inside the feet, red outside, grey in the air), the support polygon under the feet, each jump's actual hips path next to its gravity arc, and a short trail behind swinging props. It shows in scrub, playback and video export, and red frames are exactly the ones QA calls BALANCE. (#950)
• Dragging a hand or foot IK handle into another character now stops at that character's body instead of passing through, even on a fast drag across a thin forearm. Hold Alt while dragging to pass through on purpose; a one-time notice says so. The other character never moves. (#949)

Motion3

• Prop spring. objects.<id>.spring = { length, stiffness, damping } makes a carried or free prop (a bag, a lantern, a club) swing a beat behind the hand and settle. length is the string or rod length; stiffness defaults to gravity over length and damping to 0.5, so spring: { length: 0.5 } already swings naturally. Put the prop's base at the hand with at/along, because the swing pivots at the base; QA notes a base that sits far from the hand. The swing is computed once at compile time, stops when a dropped prop lands, and never pushes the prop into the floor. (#945)
• BALANCE now uses a mass-weighted centre of mass against the support polygon of the grounded feet, instead of a four-point average and a box. Its hint gives the distance and direction (for example 0.10 m ahead of the feet), and a lean that changes direction stays one issue. A hint that moves the root now moves every key that holds the pose, so the body does not slide between them. (#944, #937)
• FLOAT issues come with a fix: the root keyed onto the gravity arc between takeoff and landing, returning to the original motion at both ends. When the correction would be too large, the hint gives the apex height or the air time that would fit instead. (#943)
• fix.person (on by default) moves a character's arms out of another character's body at compile time, keeps contact you allowed in checks.allow, and gives the same take after saving and reopening. (#948)

Agent

• Kimi K3 models (kimi-k3* on the Moonshot hosts) work on the OpenAI-compatible provider with their reasoning efforts and full output limit. A turn that spends every output token before answering now says so and suggests a lower reasoning effort, instead of failing with no output. (#951, #947)

Package and tests

• jpeg-js, which the MCP image tools import, is a root dev dependency, so a development checkout runs the MCP tests without a separate install. The test runner now skips the MCP suites with a clear message when mcp/node_modules is missing. (#946, #936)
• The Studio camera QA enters look-through from the dock's Shot Camera card, where the Studio shows it. (#952, #925)

The npm package ships the MCP module the live tools need, so the Studio's live tools and cozyclay mcp work on a fresh install.

Studio

• A 3.1.5 global install shows the Update chip in the top bar for the first time, since this is the first release after the chip shipped. Update now, or the command it offers to copy, installs 3.1.6; then restart cclay.

MCP

• The npm package now ships mcp/project-camera.mjs, so the Studio's live tools and cozyclay mcp start on an npm install instead of failing with "Cannot find module" (broken since 3.1.2). The package check now fails a release whose bin/ or mcp/ code imports a file the package leaves out.

The Studio tells you when a new release is out and installs it in one click, Claude models work in the agent panel again, IK edits stay on their own character, turns and walks look more natural, and anonymous analytics show where the Studio gets in the way.

Agent

• Agent turns on Claude models no longer fail with a 400 error about a deferred placeholder tool.
• When a turn is already running, the failure chip reads busy instead of upstream. The message text is unchanged.

Motion

• The head turns first and leads the body into a turn, by about 5 frames at 24 fps, the way a person's does. flow.headLead sets the frames (0 to 12), and false turns it off. A keyed head look still wins.
• Takes that walk report observations.gait: cadence, step length, speed, stance and pelvis motion, with warnings outside a person's range. It is a reading only and never changes the QA result.
• Grasp QA reads each finger: FINGER_ROM (a joint past its range), FINGER_SELF (two fingers inside each other) and THUMB_OFF (a held object without the thumb on it).
• A carried ball keeps the thumb on it. A finger that misses a held object turns toward it at the knuckle, and the ring and little fingers curl together. Stacked hand presets no longer over-curl.

Studio

• An npm studio shows a small Update chip in the top bar when a newer release is out, once per version. A global install whose folder npm can write gets Update now, which installs the release and then asks you to restart cclay. Other installs get the command to copy, and npx gets "run npx cozyclay again". Update now waits while an agent turn, an export or a recording runs. A failed install names the cause (permissions, network, Node version, npm missing) and keeps the command.
• An IK edit stays with its own character. Selecting another character mid-drag no longer poses it, and undo no longer reverts or deletes the other character. Switching characters applies a pending IK edit and shows a notice.
• Ctrl+Z after an IK drag puts the pose back, with or without a take loaded.
• On a browser without WebGL, the unavailable notice appears one frame after the Studio first draws instead of during it.

CLI

• cclay update --check prints the current and latest version without installing, and exits 0 (up to date), 10 (update available) or 11 (unknown). cclay update now refuses a release your Node.js cannot run.
• A source checkout reports itself as clone, and a Windows global install is no longer mistaken for npx.

Site

• A redesigned cozyclay.org: a black first screen with a greybox-to-video reel, how-it-works clips from the tutorial, and Try it opens the Studio.

Analytics

• The anonymous usage analytics now cover where the Studio gets in the way:
  • the agent loop: refused commands, a summary per agent turn, each motion draft and its QA result, and each prompt sent, so retry loops and hesitation show
  • model connect: the sign-in steps and where they stop, and model changes
  • exports: retries, the stage a failed or stopped export reached, and saved files. Storyboard PNG, render pass and OTIO exports are now counted.
  • clicks, shortcuts and search: repeated or dead clicks on the main controls, shortcuts that did nothing, searches with no result, and switching panels or orbiting the camera back and forth
  • playback, boot and crashes: time to the first frame, playback runs and late frames, the first-success guide, render crashes and lost WebGL
  • the update notice: when it shows, which button was pressed, and whether the install worked
  • one friction summary per session
• Every value is a closed bucket or a fixed id. No text, names, paths, object ids, click coordinates or npm output are sent. Prompt text never leaves the browser; only a length bucket and a similarity grade to the last prompt do.
• First-edit events count only your own edits, not the agent's, and report