CozyClay is a free, open source design & prototyping project written in JavaScript and released under AGPL-3.0. It has 1,993 GitHub stars, 205 forks and 11 open issues, and was last pushed 8 hours ago. On this registry it ranks #81 of 120 tracked projects in Design & Prototyping, with 5 head-to-head comparisons available.

What is CozyClay?

CozyClay is open-source previs software that runs in a browser tab, letting a director, animator or technical artist block a set in 3D, move the cast, author camera moves and cuts, and then hand those same shots to an AI video model.

What it is

CozyClay is a JavaScript application distributed through npm under the AGPL-3.0 licence. It runs as a studio in a Chromium browser, launched locally, and asks only for Node.js 22.19 or newer — no GPU, no Python and no model download. Its scope follows the previs pipeline: stage a set and a cast, compile and QA motion, place camera shots and cuts on a timeline, then export a package for a downstream video model. The repository carries 1,993 stars and 205 forks, and the homepage is cozyclay.org.

The problem it solves is the cost model of AI video: every take costs money, and one miss means paying again. A text prompt cannot hold a whole scene — where everyone stands, how they move, where the camera is, when it cuts. CozyClay moves those decisions upstream into 3D, where they are cheap to change, and then gives the video model the shot as a first frame, a greybox reference clip and a prompt that describes the real framing, so the model follows the blocking instead of guessing. The bare text prompt is the specific thing it replaces.

Key capabilities

  • Staging: sets are built from primitives, with rigged characters or capsule stand-ins when nobody needs to move a limb, and the view flies like a 3D editor.
  • Motion: the action is described in words, an agent writes a motion spec, and a deterministic compiler in the browser bakes every frame after QA checks collisions, foot slide, reach and hand contact.
  • Shooting: shots sit on a timeline with drawn dolly rails and a lens view, and each shot knows the limits of the video model it targets.
  • Export: a keyframe pack holding first and last frame, greybox clip, camera and prompt, plus mp4, depth and normal passes, a contact sheet and an OTIO cut list.
  • Storyboard projects: a row of panels with captions, an animatic and a contact sheet for work that prefers stills to motion.
  • Agent surfaces: an agent panel opened with Cmd/Ctrl+B, an MCP server started by npx -y cozyclay mcp, and a terminal interface through cclay live status --wait.
  • Undo: every edit, including each change the agent makes, is one undo step.

Who uses it and how

  • Teams planning shots for AI video models keep framing and timing in CozyClay and export a first frame, greybox clip and prompt per shot instead of re-rolling prompts.
  • Studios working agent-first connect Claude Desktop, Claude Code, Cursor or another MCP client to a running studio via npx -y cozyclay mcp.
  • Coding agents drive a live studio from the terminal with cclay live status --wait, passing JSON in and out while an operator watches the viewport.
  • Storyboard-led productions keep a project in storyboard mode and deliver panels, an animatic and a contact sheet.
  • Because only Node.js 22.19 or newer and Chromium are required, it suits workstations and laptops without GPUs.

Getting started

Run npx cozyclay with Node.js 22.19 or newer and a Chromium browser, and the studio opens at http://127.0.0.1:5180/app/. Working from source takes git clone, npm install, npm run dev and npm test.

How it compares

Blender appears among the project's topics, but the facts describe no interchange with it and no list of paid products that CozyClay replaces, so a contrast on licence, hosting or cost model cannot be drawn here. For browser-based previs aimed at AI video generation, it stands alone in this registry.

When to use it — and when not to

CozyClay is a previs tool rather than a renderer or an editor: final frames come from the AI video model, and cut lists leave as OTIO. The agent features need a ChatGPT sign-in or your own key for Anthropic, OpenAI, Gemini, MiniMax, OpenRouter or CLIProxyAPI, so that dependency has to be planned for. The AGPL-3.0 licence, and the one-click update chip that stays off on Windows by design, are both worth weighing before standardising on it.

project readme (upstream, from github) — read inline

Make the scene first. Then make it a video.
Open source previs in a browser tab: block the set, move the cast, cut the camera, hand the shot to an AI video model.

License: AGPL-3.0 npm Node 22.19+ Stars Discord

Try it in the browser · Quick start · Guide for AI agents · Docs · Changelog · Discord

Top: the greybox blocked in CozyClay. Bottom: the AI video made from it. Same idea, a parkour jump: the blocking holds the timing and the camera.

Why

AI video costs money per take, and one miss means paying again. A text prompt cannot hold a whole scene: where everyone stands, how they move, where the camera is, when it cuts.

CozyClay lets you make those decisions first, in 3D, where they are cheap to change. Then the video model gets the shot as a first frame, a greybox reference clip and a prompt that describes the real framing. It follows the blocking instead of guessing.

flowchart LR
  S["Stage<br/>set + cast"] --> M["Motion<br/>compiled + QA"] --> C["Camera<br/>shots + cuts"] --> E["Export<br/>frame · clip · prompt"] --> V["AI video model"]

Quick start

npx cozyclay

That is the whole install. You need Node.js 22.19 or newer and a Chromium browser. You do not need a GPU, Python or a model download. The studio opens at http://127.0.0.1:5180/app/.

Updating. npx cozyclay fetches the newest release each time you run it. After npm install -g cozyclay, the studio shows a small Update chip in the top bar when a newer release is out. Update now installs it, and Restart now starts the new version in the same terminal; the studio reloads once your project is saved. On Windows the chip gives you the command to copy instead: one-click stays off there by design. cclay update does the same from the terminal. --no-update-check or COZYCLAY_NO_UPDATE_CHECK=1 turns the check off for one launch; cclay update --off turns it off for good, and cclay update --on brings it back.

Asking an AI agent to set it up? Give it this repository link. Its instructions are in INSTALL_FOR_AGENTS.md.

What you can do

Stage Build the set from primitives. Add rigged characters, or capsule stand-ins when nobody needs to move a limb. Fly the view like a 3D editor.
Move Describe the action. The agent writes a motion spec, and a deterministic compiler in the browser bakes every frame. QA checks collisions, foot slide, reach and hand contact before you see it.
Shoot Put shots on a timeline, draw dolly rails, look through the lens. Each shot knows the limits of the video model you target.
Export Keyframe pack (first and last frame, greybox clip, camera, prompt), mp4, depth and normal passes, contact sheet, OTIO cut list.
Storyboard Prefer stills? A Storyboard project is a row of panels with captions, an animatic and a contact sheet.
Undo anything Every edit, including each change the agent makes, is one undo step.

Direct it with AI

The same scene can be driven from three places, live, while you watch the viewport.

Surface Start For
Agent panel Cmd/Ctrl+B in the studio Chat in the studio. Sign in with ChatGPT or use your own key (Anthropic, OpenAI, Gemini, MiniMax, OpenRouter, CLIProxyAPI).
MCP server npx -y cozyclay mcp Claude Desktop, Claude Code, Cursor or any MCP client.
Terminal cclay live status --wait Coding agents that drive a running studio, JSON in and out.
{ "mcpServers": { "cozyclay": { "command": "npx", "args": ["-y", "cozyclay", "mcp"] } } }

From source

git clone https://github.com/HaD0Yun/CozyClay.git && cd CozyClay
npm install
npm run dev     # http://127.0.0.1:5180/app/
npm test

Docs

Read For
INSTALL_FOR_AGENTS.md Install, run and connect, written for AI agents
docs/motion3-agent-guide.md Motion specs, compile and QA
docs/agent-cli.md cclay live, model providers, sessions
mcp/README.md MCP tools and the live protocol
docs/studio-ui-ia.md Every control and where it lives
docs/privacy.md Anonymous telemetry and how to turn it off (cclay telemetry off)
AGENTS.md Contribution rules

Guides

Read For
Greybox to AI video Why a grey blockout is the most reliable input for a video model, and the block-then-generate loop
Previs software compared Free, open source and browser-based previs tools side by side
Seedance 2.5 camera control Getting the same camera on every take with a reference clip
Camera control for AI video Why camera prompts drift and what the models actually accept

Found a bug or want a feature? Open an issue.

License

AGPL-3.0-or-later. See LICENSE, LICENSING.md and THIRD_PARTY_NOTICES.md. Made by Doyun at NomaDamas.

Frequently asked questions

Is CozyClay free to use?

CozyClay is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does CozyClay do?

Open source previs software in the browser: block a scene, pose characters, author camera moves and cuts, then take the same shots to an AI video model.

What is CozyClay written in?

CozyClay is primarily written in JavaScript. Its source is publicly available at https://github.com/HaD0Yun/CozyClay, and it has 1,993 GitHub stars.