baz scenes
Manage scenes in active project
baz scenes [options] [command]| Option | Description |
|---|---|
-h, --help | display help for command |
baz scenes list
List all scenes in active project
baz scenes list [options]| Option | Description |
|---|---|
-h, --help | display help for command |
baz scenes code
Show TSX code for a scene
baz scenes code [options] [scene-id]| Option | Description |
|---|---|
--all | Show code for all scenes |
--output <path> | Write to file instead of stdout |
-h, --help | display help for command |
baz scenes delete
Delete a scene
baz scenes delete [options] <scene-id>| Option | Description |
|---|---|
--force | Skip confirmation |
-h, --help | display help for command |
baz scenes rename
Rename a scene
baz scenes rename [options] <scene-id>| Option | Description |
|---|---|
--name <name> | New scene name |
-h, --help | display help for command |
baz scenes move
Move a scene to a different track/position on the timeline
baz scenes move [options] <scene-id>| Option | Description |
|---|---|
--track <number> | Target track number |
--start <frame> | Target start frame |
--duration <frames> | New duration in frames |
-h, --help | display help for command |
baz scenes reorder
Reorder scenes by passing scene IDs in playback order
baz scenes reorder [options]| Option | Description |
|---|---|
--ids <ids> | Comma-separated scene IDs (full or unique prefix) in new playback order |
--ids-file <path> | Read IDs from file (JSON array or one ID per line) |
-h, --help | display help for command |
baz scenes create
Create a new scene from TSX code (no AI tokens spent)
baz scenes create [options]| Option | Description |
|---|---|
--name <name> | Scene name |
--file <path> | Read TSX code from file |
--code <code> | Provide TSX code inline |
--duration <frames> | Duration in frames (default: 150) Default: 150. |
--track <number> | Track number (default: 0) Default: 0. |
--start <frame> | Start frame (default: 0) Default: 0. |
-h, --help | display help for command |
baz scenes set-code
Replace scene TSX code (for agent-driven edits)
baz scenes set-code [options] <scene-id>| Option | Description |
|---|---|
--file <path> | Read new code from file |
--code <code> | Provide new code inline |
--overwrite-duration | Also update scene duration from code |
-h, --help | display help for command |
baz scenes positions
Preview or apply timeline position updates from JSON (start and duration default to frames)
baz scenes positions [options]| Option | Description |
|---|---|
--updates-file <path> | Path to JSON array (or {"updates":[...]}) |
--updates-json <json> | Inline JSON array (or {"updates":[...]}) |
--units <units> | Units for start and duration: frames or seconds Default: frames. |
--fps <fps> | Frame rate used with --units seconds Default: 30. |
--apply | Persist changes (default: dry-run preview) |
-h, --help | display help for command |
Update fields:
sceneId Required scene UUID.
start New scene start. Uses frames by default.
duration New scene duration. Uses frames by default.
track Optional target track.
autoPlace When true, move an overlapping scene to the next free track.
Timing units:
--units frames Treat start and duration as frame counts. This is the default.
--units seconds Convert start and duration to frames using --fps.
At 30 fps, start 17 seconds becomes frame 510 and duration 8 seconds becomes 240 frames.
The command is a dry run unless --apply is present.
Examples:
baz scenes positions --updates-json '[{"sceneId":"<uuid>","start":510,"duration":240}]' --project-id <id>
baz scenes positions --updates-json '[{"sceneId":"<uuid>","start":17,"duration":8}]' --units seconds --fps 30 --apply --project-id <id>baz scenes history
Show edit history for a scene
baz scenes history [options] <scene-id>| Option | Description |
|---|---|
--limit <n> | Number of iterations to show Default: 10. |
-h, --help | display help for command |
baz scenes restore
Restore scene code from a specific history iteration
baz scenes restore [options] <scene-id>| Option | Description |
|---|---|
--iteration <iteration-id> | Iteration ID to restore (full or prefix) |
--force | Skip confirmation |
-h, --help | display help for command |
baz scenes undo
Restore the latest restorable scene code iteration
baz scenes undo [options] <scene-id>| Option | Description |
|---|---|
--force | Skip confirmation |
-h, --help | display help for command |