baz.studio API

baz scenes

Manage scenes in active project

baz scenes [options] [command]
OptionDescription
-h, --helpdisplay help for command

baz scenes list

List all scenes in active project

baz scenes list [options]
OptionDescription
-h, --helpdisplay help for command

baz scenes code

Show TSX code for a scene

baz scenes code [options] [scene-id]
OptionDescription
--allShow code for all scenes
--output <path>Write to file instead of stdout
-h, --helpdisplay help for command

baz scenes delete

Delete a scene

baz scenes delete [options] <scene-id>
OptionDescription
--forceSkip confirmation
-h, --helpdisplay help for command

baz scenes rename

Rename a scene

baz scenes rename [options] <scene-id>
OptionDescription
--name <name>New scene name
-h, --helpdisplay help for command

baz scenes move

Move a scene to a different track/position on the timeline

baz scenes move [options] <scene-id>
OptionDescription
--track <number>Target track number
--start <frame>Target start frame
--duration <frames>New duration in frames
-h, --helpdisplay help for command

baz scenes reorder

Reorder scenes by passing scene IDs in playback order

baz scenes reorder [options]
OptionDescription
--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, --helpdisplay help for command

baz scenes create

Create a new scene from TSX code (no AI tokens spent)

baz scenes create [options]
OptionDescription
--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, --helpdisplay help for command

baz scenes set-code

Replace scene TSX code (for agent-driven edits)

baz scenes set-code [options] <scene-id>
OptionDescription
--file <path>Read new code from file
--code <code>Provide new code inline
--overwrite-durationAlso update scene duration from code
-h, --helpdisplay help for command

baz scenes positions

Preview or apply timeline position updates from JSON

baz scenes positions [options]
OptionDescription
--updates-file <path>Path to JSON array (or {"updates":[...]})
--updates-json <json>Inline JSON array (or {"updates":[...]})
--applyPersist changes (default: dry-run preview)
-h, --helpdisplay help for command

baz scenes history

Show edit history for a scene

baz scenes history [options] <scene-id>
OptionDescription
--limit <n>Number of iterations to show Default: 10.
-h, --helpdisplay help for command

baz scenes restore

Restore scene code from a specific history iteration

baz scenes restore [options] <scene-id>
OptionDescription
--iteration <iteration-id>Iteration ID to restore (full or prefix)
--forceSkip confirmation
-h, --helpdisplay help for command

baz scenes undo

Restore the latest restorable scene code iteration

baz scenes undo [options] <scene-id>
OptionDescription
--forceSkip confirmation
-h, --helpdisplay help for command