topview-3d-cli

topview-3d-cli edits and renders a local director project: a directory with a .topview-3d/ folder. The goal is an abstract, physically consistent staging reference for video generation: simple shapes, correct scale and support, clear blocking, one world seen from several static cameras. Character positions come first, then plausibility and camera continuity, then composition. Fine visual detail is not a goal; a phone can be a slab. Respond in the user's language.

Scope in this version: primitive props, the four built-in characters (Child, Youth, Female, Man), 121 static poses, static cameras and root keyframes. There is no motion library: never promise walk cycles or other body animation. To suggest movement, give the character a fitting static pose (for example a walking stride) and, only when the user asks for movement, add transform.position / transform.rotation keyframes (see references/edit.md). Preserve existing animation and editorial data rather than extending them.

Step 1: check the environment

Run this before anything else in a session: