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 (or raea alone) lists every verb's forms. raea help --json gives 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 REFUSED that 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 library needs the raea app running, and adding a folder waits for a person's yes in the app.
Sessions. Each render and play records its session; raea traces lists them.
Version. raea --version prints 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 export`	The composition as a CapCut draft ready in its timeline: its footage and sounds as clips of their own files at their trims and gains, everything raea draws as transparent overlay clips above them.
`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 component`	Copy a ready-made component or set into the project's components/, or the workspace's shared/components/, to use and change as your own.
`raea part`	The old name of raea component: copy a ready-made component 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, a project against every rule it holds, 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 fingerprint`	A person's sense of good work, learned on this Mac: axes with small heads over on-device encoders that score a render moment by moment and say what they can't judge yet.
`raea findings`	What each render and check found, read back from the project's record: fixed, new and carried since the one before.
`raea scene`	Find floating, sunk and clipping 3D parts, say what each part rests on, and meter a shot's light.
`raea world`	A frame as one world: its layers, text, 3D parts, camera, shots, clips, cues and lines as entities, queried across media.
`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`	Every agent's tool hooks: media opened in the Mac's viewer goes to raea show, and the quick check after a composition is saved.
`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 , a screen recording for , from where its face is.
`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 , on this Mac's GPU.
`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, Blender and Godot.

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 and play: rigid bodies, soft goo, and parts cut out of a .glb.
`raea blender`	Run a Blender Python script headless, with raea's library of mesh scripts: convert, decimate, repair, split, bake, rig, cloth.
`raea godot`	Run a TypeScript script against Godot's whole API in a headless Godot with GodotJS, record what it draws as frames, or open the editor on the project.

Agents and setup

What an agent reads and shows the person, 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 notes`	A person's notes as files the work is held to: each taken word for word, then restated as asks before anything changes.
`raea show`	Show the person something in the raea app, as an item they can use and answer: stills, a video, a sound, a script, an interactive .tsx or a question.
`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 raea's add-on and the MCP add-on.

#How every verb behaves

#Make

#Projects

#Check

#Footage

#Sound

#Generate and 3D tools

#Agents and setup