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 (start and duration default to frames)

baz scenes positions [options]
OptionDescription
--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.
--applyPersist changes (default: dry-run preview)
-h, --helpdisplay 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>
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