CLI
Every raea verb: what it does, its forms, where it runs and each flag.
raea is one program with a verb for each job. Each verb has a page here with its forms, where it runs, every flag
it takes and what each one does. The forms and flags are generated from the binary itself (raea help --json), so
they match the version they were made from; the prose around them is written by hand.
How every verb behaves
- Help.
raea help(orraeaalone) lists every verb's forms.raea help --jsongives the same as data: each verb's forms, its flags, how many values each flag takes, how many arguments it takes and where it runs. - Strict arguments. A verb refuses a flag or an argument its forms don't name, rather than ignoring it, so a
typo is caught. The four verbs with parsers of their own (
media,gen,physics,blender) list their own forms. - Output. A verb prints its result on stdout and exits 0. When it can't do what it was asked, it prints a line
starting with
REFUSEDthat says why and what to do instead, and exits 1. A file refused again is told what changed since the last refusal. - Where it runs. Almost every verb is headless: it needs nothing running and opens no window, so it works over
SSH, in CI and from an agent.
raea libraryneeds the raea app running, and adding a folder waits for a person's yes in the app. - Sessions. Each
renderandplayrecords its session;raea traceslists them. - Version.
raea --versionprints the version. The agent skill and these pages match it.
Make
Render, play and package what you wrote.
| Verb | What it does |
|---|---|
raea render | Render a composition to an MP4, a PNG or a folder of frames, on the GPU and headless. |
raea play | Play a game live in a window, or headless with scripted keys, snapshots and a timing report. |
raea export-game | Package a game as a program of its own: a Mac app or a command-line program. |
raea bundle | Bundle a composition into one JavaScript file that render_bundle draws, on the Mac or the iPhone. |
raea app | Run, check headless and package a desktop app written as one TSX file on @raea/ui. |
raea run | Run a TypeScript program on the engine, headless, and print what it prints. |
Projects
The workspace, its projects and what a project holds.
| Verb | What it does |
|---|---|
raea init | Add a project's starting files where they're missing: edit.tsx, cuts.ts, components/ and AGENTS.md. |
raea workspace | Make, adopt or show a workspace: the git repository that holds a studio's projects and controllers. |
raea project | Make a project in the workspace, list them, or move one between inline and a repository of its own. |
raea controller | Read and change the workspace's controllers: its settings and workflows, each a TypeScript file. |
raea spec | Print a spec file's default export as JSON, checked against its schema: briefs, scripts, taste, plans and controllers. |
raea part | Copy a ready-made part into the project's components/, to use and change as your own. |
raea add | Add, remove and install npm packages for a project, with no Node or npm: raea.lock and node_modules. |
raea brand | Read a brand kit from a website on this machine: colours, fonts and logos into brand/ and BRAND.md. |
raea library | Search and manage the person's media libraries in the raea app: folders and drives indexed on this machine, searched by meaning. |
Check
What's wrong before anyone watches it.
| Verb | What it does |
|---|---|
raea check | Check a composition's text in a second, or an export against the floor: text, contrast, safe areas, freezes, flashing, cues and loudness. |
raea judge | Judge a 3D scene's review sheets blind, by a model on a frozen rubric or a fresh agent session, with the pass decided in code. |
raea scene | Find floating, sunk and clipping 3D parts, say what each part rests on, and meter a shot's light. |
raea solid | Measure, view and export a solid: parts built from code with exact volumes, joints and parameters. |
raea next | The two or three most useful next steps for a project, read from its brief, compositions, renders and checks. |
raea doctor | Find what doesn't match this version of raea: old brief files, an older workspace format, an agent's stale skill. |
raea hook | Claude Code's PostToolUse hook: the quick text check after an agent saves a composition. |
raea traces | List the sessions raea apps left, newest first, with how each ended and its glitches, or tell one in full. |
Footage
Takes, cuts and the camera, from your own media.
| Verb | What it does |
|---|---|
raea media | Probe, cut, measure and encode media natively, the same on the Mac and the iPhone, with no ffmpeg. |
raea cut | Cut a take to the lines it says, transcribing it first, and write cuts.ts and words.json. |
raea frame | Say how a take fits the edit: a talking take for |
raea track | Solve a clip's camera on this machine, so 3D can stand in its world with |
raea splat | Train footage of a real place or thing into a 3D Gaussian splat for |
raea mezz | Make an intra-only ProRes copy of each long-GOP source over 1080p, so scrubbing it is smooth. |
raea neural | Run DLSS 5 neural rendering over a render's frames on the Mac, through your own MLX-DLSS build and weights. |
Sound
Music read, foley and instruments made on this machine.
| Verb | What it does |
|---|---|
raea song | Read a song's energy map: beats, bars, sections, builds, drops, stops, hits and cuts per bar. |
raea sounds | Search open sample libraries for instruments and drums, and fetch one for a Sampler. |
raea sao | Make a sound effect from a description with Stable Audio Open, on this machine. |
raea tokensynth | Make an instrument's notes from a description of its timbre with TokenSynth, on this machine. |
raea setup-audio | Install or check the local audio models: Stable Audio Open for foley and TokenSynth for instruments. |
Generate and 3D tools
Generated media, physics bakes and Blender.
| Verb | What it does |
|---|---|
raea gen | Generate images, video, music, sound, speech, 3D models and text through made.app, fal, Replicate, OpenRouter, Modal or ComfyUI. |
raea physics | Make the bakes |
raea blender | Run a Blender Python script headless, with raea's library of mesh scripts: convert, decimate, repair, split, bake, rig, cloth. |
Agents and setup
What an agent reads, and the tools raea installs.
| Verb | What it does |
|---|---|
raea guide | Print raea's craft guides: the floor read before any edit, the modes, the notes and the 3D guides. |
raea context | Print what to read before working on a project: its taste, brief and look, the floor and its modes' guides. |
raea skill | Print the agent skill this raea ships, matched to its version, or one of its references. |
raea skills | Install raea's agent skill where Claude Code, Codex, Kimi or Gemini read skills, with its MCP server and hook. |
raea setup | Find Blender, or download its current LTS, and install its MCP add-on. |