@vfrey/vfrey 0.0.1 → 1.0.0-beta.1

package/LICENSE

@@ -1 +1,34 @@
+vfrey License
+
 Copyright (c) 2026 vfrey. All rights reserved.
+
+1. Grant. During the beta, vfrey grants you a free, non-exclusive,
+   non-transferable right to install and use this package for your own
+   purposes, including making and publishing videos with it.
+
+2. Restrictions. You may not:
+   - redistribute this package or any part of it;
+   - modify it for the purpose of redistributing it;
+   - reverse-engineer it, or use it, to build a product that competes
+     with vfrey;
+   - sublicense, sell, rent or lend it.
+
+3. Your videos. Videos and files you make with vfrey belong to you.
+
+4. Third-party components. This package includes third-party software that
+   keeps its own license. The vendored Framey engine (vendor/framey) is
+   Apache-2.0 and based on HeyGen HyperFrames; see vendor/framey/LICENSE and
+   vendor/framey/NOTICE. Dependencies installed in node_modules carry their
+   own licenses. This license does not change them.
+
+5. No warranty. This package is provided "as is", without warranty of any
+   kind, express or implied, including merchantability, fitness for a
+   particular purpose and non-infringement. It is beta software.
+
+6. Limitation of liability. To the extent the law allows, vfrey is not
+   liable for any claim, damages or other liability arising from the use of
+   this package. You are responsible for what you publish and for
+   following each platform's rules.
+
+7. Ending. This license ends if you break it. vfrey may end the beta and
+   this free grant on notice.

package/README.md

@@ -1,5 +1,80 @@
-# @vfrey/vfrey
+# vfrey
 
-vfrey makes short vertical videos by asking your own coding agent.
+Make short vertical videos by asking your own coding agent. The agent designs each video as code, so there is no template ceiling, and you own the files.
 
-This package is a placeholder. vfrey is not released on npm yet. See https://vfrey.vercel.app.
+Status: **beta**. Private beta; see [vfrey.vercel.app](https://vfrey.vercel.app).
+
+## Quick start
+
+```bash
+npm create vfrey@latest my-channel
+cd my-channel
+```
+
+> **Note:** during the beta use `npm create vfrey@beta my-channel`. `npx create-vfrey my-channel` does the same thing.
+
+Already have a folder? Run `npx @vfrey/vfrey init` in it. Inside a project, `npx vfrey ...` runs that project's own copy. To type `vfrey ...` anywhere, install it once with `npm i -g @vfrey/vfrey`.
+
+Open the folder in your coding agent (Claude Code, Codex, Grok, Cursor or Gemini CLI) and ask:
+
+> make me a short about how octopuses change color
+
+The agent writes the script, designs the scene, renders the video into `videos/`, and shows it to you. To look at your videos and runs yourself:
+
+```bash
+npx vfrey open
+```
+
+## What you get
+
+- **A project folder per channel.** `vfrey.json`, `AGENTS.md`, `CLAUDE.md` and `GEMINI.md` that tell any agent what to do, the vfrey skill for each agent, `scenes/`, `scripts/`, `videos/`, and a private `.vfrey/` data folder.
+- **Readable videos.** `videos/2026-10-26 How octopuses change color.mp4` with the transcript beside it as `.txt`.
+- **A local dashboard** on your machine: a board of runs, a timeline for each one, and the video. `npx vfrey open` starts or reuses it.
+- **Three render engines**: Remotion, Framey (HTML and GSAP) and HyperFrames (when its CLI is installed). 1080x1920 at 30 fps.
+- **Voice and word-timed captions** that follow the spoken words.
+- **An `AI-GENERATED` label burned into every video.** A scene cannot cover it.
+- **Publishing through official APIs** (YouTube, TikTok, Instagram, Facebook) when you add your own keys, always with the platform's AI-disclosure flag set. With no key, nothing is uploaded and the video stays on your machine.
+
+## Works with
+
+| Agent | Reads |
+| --- | --- |
+| Claude Code | `CLAUDE.md`, `.claude/skills/vfrey/` |
+| Codex | `AGENTS.md`, `.agents/skills/vfrey/` |
+| Grok | `AGENTS.md`, `.agents/skills/vfrey/` |
+| Cursor | `AGENTS.md`, `.agents/skills/vfrey/` |
+| Gemini CLI | `GEMINI.md`, `.agents/skills/vfrey/` |
+
+## Requirements
+
+- Node 22.13 or newer.
+- A voice: macOS speaks with the built-in `say` command. On another system set `TTS_PROVIDER=openai` (paid voice, needs a key) or `TTS_PROVIDER=none` (silent video).
+- Chrome Headless Shell, downloaded on your first render (about 170 MB).
+- A coding agent from the table above. vfrey has no model of its own; you pay for your agent, not per video.
+
+Run `npx vfrey doctor` to check your machine.
+
+## Commands an agent uses
+
+| Command | What it does |
+| --- | --- |
+| `npx vfrey doctor` | Checks the machine and prints a fix for anything wrong |
+| `npx vfrey scene init DIR` | Writes a starter scene to replace with a design for the idea |
+| `npx vfrey render --scene DIR --engine <id> --script script.json --frame 2.5 out.png` | Looks at one frame before rendering |
+| `npx vfrey tick --now --about "<subject>" --script script.json --scene DIR --engine <id>` | Makes the video |
+| `npx vfrey videos` | Lists your finished videos, newest first |
+| `npx vfrey open` | Opens the dashboard |
+| `npx vfrey engine list` | Shows which engines are ready |
+
+`npx vfrey --help` lists everything.
+
+## Links
+
+- Docs: https://vfrey.vercel.app/docs
+- Site: https://vfrey.vercel.app
+
+Roadmap: scheduled autopilot posting across several channels, then a hosted tier.
+
+## License
+
+Proprietary. Free to install and use during the beta. See [LICENSE](LICENSE). Third-party components keep their own licenses.

package/accounts.example.json

@@ -0,0 +1,61 @@
+{
+  "accounts": [
+    {
+      "id": "desk",
+      "niche": "mortgage lock desks for first-time buyers",
+      "language": "en",
+      "voices": ["alloy", "nova"],
+      "hashtagPool": ["#lockdesk", "#mortgage"],
+      "waiveAudioRotation": false,
+      "cadence": {
+        "timezone": "America/New_York",
+        "minHoursBetweenPosts": 20,
+        "maxPostsPerDay": 1,
+        "windows": ["09:00-11:30", "17:00-19:00"]
+      },
+      "sources": {
+        "rss": ["https://www.federalreserve.gov/feeds/press_all.xml"],
+        "subreddits": ["FirstTimeHomeBuyer"],
+        "youtubeChannelIds": [],
+        "youtubeTrendingRegion": null
+      },
+      "platforms": {
+        "youtube": {
+          "enabled": true,
+          "privacyStatus": "private",
+          "categoryId": "27",
+          "madeForKids": false,
+          "refreshTokenEnv": "YT_REFRESH_TOKEN",
+          "clientIdEnv": "GOOGLE_CLIENT_ID",
+          "clientSecretEnv": "GOOGLE_CLIENT_SECRET"
+        },
+        "tiktok": {
+          "enabled": true,
+          "privacyLevel": "SELF_ONLY",
+          "refreshTokenEnv": "TT_REFRESH_TOKEN",
+          "openIdEnv": "TT_OPEN_ID",
+          "brandContent": false,
+          "brandOrganic": false,
+          "disableComment": false
+        },
+        "instagram": {
+          "enabled": false,
+          "igUserIdEnv": "IG_USER_ID",
+          "accessTokenEnv": "IG_ACCESS_TOKEN",
+          "shareToFeed": true
+        },
+        "facebook": {
+          "enabled": false,
+          "pageIdEnv": "FB_PAGE_ID",
+          "pageTokenEnv": "FB_PAGE_TOKEN"
+        }
+      },
+      "engage": {
+        "enabled": true,
+        "allowSpicy": true,
+        "maxRepliesPerDay": 20,
+        "minSecondsBetweenReplies": 45
+      }
+    }
+  ]
+}

package/accounts.first-run.json

@@ -0,0 +1,41 @@
+{
+  "accounts": [
+    {
+      "id": "desk",
+      "niche": "what the vfrey pipeline does on a first run",
+      "language": "en",
+      "voices": ["alloy"],
+      "hashtagPool": ["#vfrey"],
+      "waiveAudioRotation": true,
+      "cadence": {
+        "timezone": "UTC",
+        "minHoursBetweenPosts": 0,
+        "maxPostsPerDay": 1,
+        "windows": []
+      },
+      "sources": {
+        "rss": ["https://www.federalreserve.gov/feeds/press_all.xml"],
+        "subreddits": [],
+        "youtubeChannelIds": [],
+        "youtubeTrendingRegion": null
+      },
+      "platforms": {
+        "youtube": {
+          "enabled": true,
+          "privacyStatus": "private",
+          "categoryId": "27",
+          "madeForKids": false,
+          "refreshTokenEnv": "YT_REFRESH_TOKEN",
+          "clientIdEnv": "GOOGLE_CLIENT_ID",
+          "clientSecretEnv": "GOOGLE_CLIENT_SECRET"
+        }
+      },
+      "engage": {
+        "enabled": false,
+        "allowSpicy": false,
+        "maxRepliesPerDay": 0,
+        "minSecondsBetweenReplies": 45
+      }
+    }
+  ]
+}

package/bin/vfrey.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const require = createRequire(import.meta.url);
+const tsx = require.resolve("tsx");
+const cli = path.join(root, "src/cli.ts");
+
+// .env in the working directory loads only when it exists, so Node prints no "not found" notice.
+// The SQLite experimental warning is silenced too: stdout and stderr carry the command's own output only.
+const envFlags = existsSync(path.resolve(process.cwd(), ".env")) ? ["--env-file=.env"] : [];
+const child = spawn(
+  process.execPath,
+  ["--experimental-sqlite", "--disable-warning=ExperimentalWarning", ...envFlags, "--import", tsx, cli, ...process.argv.slice(2)],
+  { stdio: "inherit", env: process.env },
+);
+
+// A stop signal for this process is a stop signal for the command it runs.
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => {
+    if (child.exitCode === null && child.signalCode === null) child.kill(signal);
+  });
+}
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.removeAllListeners(signal);
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/integration-tools/README.md

@@ -0,0 +1,43 @@
+# Integration tools
+
+Engines a coding agent can run on the machine to make a video or a still. The input is code or a file the agent writes. The render happens locally. There is no per-image or per-second generation bill.
+
+This is the same class of tool as Remotion. It is not a hosted image model, a video model, or a stock API.
+
+## Pick one
+
+| Need | Tool | Language | Output |
+| --- | --- | --- | --- |
+| Narrated or designed React short, the way this repo already renders | [Remotion](video/remotion.md) | React | MP4, PNG still |
+| TypeScript motion graphic, generator style | [Motion Canvas](video/motion-canvas.md) | TypeScript | MP4, image sequence |
+| TypeScript video rendered on your own process | [Revideo](video/revideo.md) | TypeScript | MP4 |
+| Math, diagrams, explainers drawn as code | [Manim](video/manim.md) | Python | MP4 |
+| Cut, join, scale, or mux files that already exist | [FFmpeg](video/ffmpeg.md) | CLI | MP4, WAV, PNG |
+| 3D or a full scene file | [Blender](video/blender.md) | Python | MP4, PNG |
+| A designed still from a layout | [Satori](image/satori.md) | JSX | SVG, then PNG |
+| Resize, composite, or convert a raster or SVG | [Sharp](image/sharp.md) | Node | PNG, WebP |
+| Draw an SVG and export a PNG | [resvg](image/resvg.md) | Node or CLI | PNG |
+| Screenshot HTML you already wrote | [Playwright](image/playwright.md) | Node | PNG |
+| Draw a still in Python | [Pillow](image/pillow.md) | Python | PNG |
+
+## Rules for an agent
+
+- Prefer the tool already installed. This repo has Remotion and FFmpeg. Use those before adding a dependency.
+- Write the source, render, then check the file exists and has a duration or a pixel size. Do not claim a render you did not run.
+- A still is an image. A film is a video. Do not render a 90 second MP4 when the task is a cover.
+- Do not send the picture to a paid generation API from this folder. If a tool has a cloud render tier, use the local renderer.
+- Do not put secrets, tokens, or API keys in an example.
+
+## Not in this list
+
+These are real tools and the wrong answer for "free, local, like Remotion":
+
+- Hosted image and video models. They bill per picture or per second.
+- HyperFrames. It renders HTML locally, and it also meters usage. Check `npx hyperframes usage` before a run. A failed or unknown usage check is not permission to render.
+- Remotion's own cloud render and any Lambda render. The local `renderMedia` path is the one this folder means.
+- Inngest. The server source is public under the Server Side Public License, not an open-source media engine.
+- OpenRouter, Firebase, Mintlify, and the Google Cloud console. Those are services.
+
+## License, said once
+
+Local does not always mean free for every company. Remotion is free for an individual and for a for-profit organization of up to 3 employees. A larger company needs a Remotion license. The other tools below name their own license in the tool file. Read it before you ship the output for a client.

package/integration-tools/image/pillow.md

@@ -0,0 +1,32 @@
+# Pillow
+
+Draws a raster image in Python. Rectangles, text, and pasted logos. No browser and no account.
+
+License: MIT-CMU, the Historical Permission Notice, for `python-pillow/Pillow`. It is the maintained fork of PIL.
+
+## Use it when
+
+A script already in Python needs a simple still: a solid plate, a label, a diagram of boxes.
+
+## Do not use it when
+
+The layout is real CSS, wrapping text, or a web font with kerning you care about. Use Satori or Playwright.
+
+## Example
+
+```python
+from PIL import Image, ImageDraw, ImageFont
+
+image = Image.new("RGB", (1080, 1920), "#0f1115")
+draw = ImageDraw.Draw(image)
+font = ImageFont.truetype("/System/Library/Fonts/Supplemental/Arial.ttf", 96)
+draw.text((80, 200), "Hello", fill="#f6f3ec", font=font)
+image.save("cover.png")
+```
+
+The Arial path is macOS. On another machine, pass a font file you shipped in the repo. `ImageFont.load_default()` is tiny and looks wrong at cover size.
+
+## Agent notes
+
+- Save, then open the file and check `image.size` is `(1080, 1920)`.
+- Paste a logo with `image.paste(logo, (x, y), logo)` only when the logo has an alpha channel. Without the mask, the corners become a box.

package/integration-tools/image/playwright.md

@@ -0,0 +1,33 @@
+# Playwright
+
+Opens a local HTML file in a headless browser and saves a screenshot. The design is HTML and CSS. The PNG is the viewport.
+
+License: Apache-2.0.
+
+Chrome on this machine can also screenshot with `--headless=new --screenshot`. Prefer Playwright when you need a settled load, a font, or a selector. Prefer the Chrome flag only when Playwright is not installed and the page is one file.
+
+## Use it when
+
+The still is a web layout: a card, a fake phone, a docs page, a cover built as HTML.
+
+## Do not use it when
+
+You need a timeline. A screenshot is one frame.
+
+## Example
+
+```ts
+import {chromium} from "playwright";
+
+const browser = await chromium.launch();
+const page = await browser.newPage({viewport: {width: 1080, height: 1920}, deviceScaleFactor: 1});
+await page.goto("file://" + process.cwd() + "/cover.html", {waitUntil: "networkidle"});
+await page.screenshot({path: "cover.png"});
+await browser.close();
+```
+
+## Agent notes
+
+- Set the viewport. A default window is not 1080x1920.
+- `networkidle` matters when the page loads a logo. A shot taken before the image arrives is a broken cover.
+- Do not point `goto` at a site you were not asked to capture.

package/integration-tools/image/resvg.md

@@ -0,0 +1,36 @@
+# resvg
+
+Renders an SVG file to a PNG. The drawing is the SVG you wrote. The renderer does not redesign it.
+
+License: MPL-2.0 for the Rust project `linebender/resvg`. The Node binding `@resvg/resvg-js` follows that package. Read the license if you ship the binding.
+
+## Use it when
+
+The picture is an SVG you can write by hand: a logo lockup, an icon, a simple cover.
+
+## Do not use it when
+
+The SVG is mostly HTML and CSS layout. Browsers and Satori handle that. resvg handles SVG.
+
+## Example
+
+```ts
+import {Resvg} from "@resvg/resvg-js";
+import {readFileSync, writeFileSync} from "node:fs";
+
+const png = new Resvg(readFileSync("cover.svg"), {fitTo: {mode: "width", value: 1080}}).render();
+writeFileSync("cover.png", png.asPng());
+```
+
+The CLI, when the package is installed:
+
+```bash
+npx resvg-js cover.svg cover.png
+```
+
+If that binary name is not the one the installed package exposes, read `package.json` of `@resvg/resvg-js` and use the script it names.
+
+## Agent notes
+
+- Give the SVG a `width` and a `height`, or pass `fitTo`. A missing size becomes a surprise.
+- A font used in `<text>` must be installed or passed in `font.fontFiles`. Outlined paths do not need a font.

package/integration-tools/image/satori.md

@@ -0,0 +1,36 @@
+# Satori
+
+Turns a JSX tree into an SVG. Pair it with resvg and you get a PNG. The layout is CSS-like. Nothing leaves the machine.
+
+License: MPL-2.0 for `vercel/satori`. resvg has its own license. Read both if you ship the libraries, not just a PNG.
+
+## Use it when
+
+You need a cover, an Open Graph card, or a title still with real text and a few shapes, and you do not want a browser.
+
+## Do not use it when
+
+The image is a frame of a timeline. Render a Remotion still. Satori has no frame clock.
+
+## Example
+
+```tsx
+import satori from "satori";
+import {Resvg} from "@resvg/resvg-js";
+import {writeFileSync} from "node:fs";
+
+const svg = await satori(
+  <div style={{width: "100%", height: "100%", background: "#0f1115", color: "#f6f3ec", fontSize: 96, padding: 80}}>
+    Hello
+  </div>,
+  {width: 1080, height: 1920, fonts: [{name: "Inter", data: fontBytes, weight: 700}]},
+);
+writeFileSync("cover.png", new Resvg(svg).render().asPng());
+```
+
+You must pass a real font file in `fonts`. Satori does not fall back to a system font. If the text is missing, the font was not loaded.
+
+## Agent notes
+
+- Width and height are the image size. Set them. Do not rely on a screenshot scale.
+- Open the PNG after writing it. A successful process exit with an empty file is a failed render.

package/integration-tools/image/sharp.md

@@ -0,0 +1,38 @@
+# Sharp
+
+A Node library for raster images. It resizes, composites, converts SVG to PNG, and writes WebP. It uses libvips. The work is local.
+
+License: Apache-2.0.
+
+## Use it when
+
+You already have a PNG, JPG, or SVG and you need another size, a crop, or a format change.
+
+## Do not use it when
+
+You still have to design the layout from scratch and the layout is mostly text. Satori or a Playwright screenshot of HTML is the clearer tool.
+
+## Example
+
+```ts
+import sharp from "sharp";
+
+await sharp("logo.svg")
+  .resize(1080, 1920, {fit: "contain", background: "#0f1115"})
+  .png()
+  .toFile("cover.png");
+```
+
+Composite a logo onto a plate:
+
+```ts
+await sharp({create: {width: 1080, height: 1920, channels: 4, background: "#0f1115"}})
+  .composite([{input: "logo.png", gravity: "centre"}])
+  .png()
+  .toFile("cover.png");
+```
+
+## Agent notes
+
+- `fit: "contain"` letterboxes. `fit: "cover"` crops. Pick one and say which.
+- Read `cover.png` back, or at least `sharp(file).metadata()`, before you say the size is 1080x1920.

package/integration-tools/video/blender.md

@@ -0,0 +1,34 @@
+# Blender
+
+A full 3D scene, rendered with no display. The scene is a `.blend` file or a Python script Blender runs. The render is local.
+
+License: GPL. The program is free. A render you make is yours. Linking Blender into a closed app is a different question. Read the GPL before you embed it.
+
+## Use it when
+
+The shot is a 3D object, a camera move, or a lighting setup that a 2D composition would fake badly.
+
+## Do not use it when
+
+The shot is type, a card, and a logo. That is Remotion. Blender is a large install and a slow render.
+
+## Example
+
+```bash
+blender -b scene.blend -o //frame_ -F PNG -f 1
+blender -b scene.blend -o //shot_ -a
+```
+
+`-b` is background. `-f 1` is one frame. `-a` is the animation. `//` is the path next to the blend file.
+
+Drive a scene from Python:
+
+```bash
+blender -b --python shot.py
+```
+
+## Agent notes
+
+- Check that `blender` is on `PATH` before you write a long script. If it is missing, say so. Do not pretend the render ran.
+- One frame first. Then the animation.
+- Name the output. Blender's default path is easy to lose.

package/integration-tools/video/ffmpeg.md

@@ -0,0 +1,41 @@
+# FFmpeg
+
+The local tool that reads and writes media files. It cuts, joins, scales, overlays a still, and muxes a voice onto a silent picture. It does not invent a scene.
+
+License: FFmpeg builds are LGPL or GPL depending on how they were compiled. `ffmpeg -version` shows which. Do not ship a GPL build inside a closed app without reading that line.
+
+This machine already has `ffmpeg` and `ffprobe`. The pipeline uses them for voice files.
+
+## Use it when
+
+The pictures already exist and you need one file: trim, concat, scale to 1080x1920, or add audio.
+
+## Do not use it when
+
+You still have to design the frames. Write those in Remotion, Motion Canvas, or Manim, then come back here to mux.
+
+## Example
+
+Silent color plate, three seconds, vertical:
+
+```bash
+ffmpeg -y -f lavfi -i color=c=0x0f1115:s=1080x1920:d=3 -pix_fmt yuv420p out/plate.mp4
+```
+
+Put a voice on a silent MP4 without re-encoding the picture:
+
+```bash
+ffmpeg -y -i picture.mp4 -i voice.wav -c:v copy -c:a aac -shortest out/with-voice.mp4
+```
+
+Duration:
+
+```bash
+ffprobe -v error -show_entries format=duration -of csv=p=0 out/with-voice.mp4
+```
+
+## Agent notes
+
+- `-shortest` ends the file when the shorter input ends. Use it on purpose.
+- `apad=pad_dur=0.28` adds a quiet tail so the last word is not cut. The pipeline voice takes use that.
+- Do not download a media file from a random URL to use as footage.

package/integration-tools/video/manim.md

@@ -0,0 +1,37 @@
+# Manim
+
+Python scenes draw shapes, text, and graphs, then play them. Manim Community Edition renders a local MP4. No account.
+
+License: MIT for Manim Community (`ManimCommunity/manim`). The original 3b1b Manim is a different repository. Use Community unless the user named the other one.
+
+## Use it when
+
+The picture is a diagram, an equation, a geometric proof, or a lesson where shapes move because the code says so.
+
+## Do not use it when
+
+The picture is a product UI or a captioned social short in this repo's house style. Use Remotion.
+
+## Example
+
+```python
+from manim import *
+
+class Hello(Scene):
+    def construct(self):
+        title = Text("Hello")
+        self.play(Write(title))
+        self.wait()
+```
+
+```bash
+pip install manim
+manim -pql hello.py Hello
+```
+
+`-ql` is a low-quality preview. Drop `p` on a machine with no display. Use `-qh` only when the preview is already right.
+
+## Agent notes
+
+- The class name and the file name are both required. `manim file.py Hello` renders the `Hello` class.
+- The MP4 path is printed at the end. Check that path. Do not assume `out/hello.mp4`.

package/integration-tools/video/motion-canvas.md

@@ -0,0 +1,37 @@
+# Motion Canvas
+
+A TypeScript scene yields animation steps. The editor shows the result while you edit. The CLI renders an image sequence or a video on this machine.
+
+License: MIT. Repository: `motion-canvas/motion-canvas`.
+
+## Use it when
+
+The piece is a motion graphic or a code explainer and you want a generator (`yield*`) instead of a React frame clock. You do not need this repo's existing Remotion templates.
+
+## Do not use it when
+
+The short must live in `src/remotion/` and ship through `npm run tick`. Use Remotion for that.
+
+## Example
+
+```tsx
+import {makeScene2D, Txt} from "@motion-canvas/2d";
+import {createRef} from "@motion-canvas/core";
+
+export default makeScene2D(function* (view) {
+  const title = createRef<Txt>();
+  view.add(<Txt ref={title} text="Hello" fill="#f6f3ec" fontSize={120} />);
+  yield* title().scale(1.2, 0.6);
+});
+```
+
+Scaffold a project, then render with that project's CLI. The maintained CLI package is `@motion-canvas/cli`. Read the scaffold's `package.json` for the exact script name before you invent a flag. A typical render is:
+
+```bash
+npx @motion-canvas/cli render --project src/project.ts
+```
+
+## Agent notes
+
+- The preview and the render must use the same project file. A scene that is not registered in the project does not render.
+- Confirm the output file and its duration after the command exits.