simforge timeline

Reference for simforge timeline: usage, arguments and flags, generated from the CLI.

Generated from the CLI’s own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the command reference.

timeline build

Build the render timeline for a workspace’s trace (deterministic, content-keyed)

simforge timeline build [OPTIONS] [WORKSPACE]

Runs on: local runtime.

Argument / flag	Notes	What
<workspace>		The workspace directory (an imported scenario package). Omit it and pass —trace instead
--trace FILE		A trace file (JSON or gzip; any released trace format) instead of a workspace
--recorded-trace-sha256 SHA256		The identity recorded next to the stored trace (bound to an upgraded trace; checked against a current one)
--catalog-digest SHA256		Actor-catalog closure digest to key the timeline by (a workspace supplies its own)
--height HEIGHT	one of auto, ground, flat; default auto	The height source
--flat-z METRES		Elevation of the plane for —height flat
--map-dir DIR		Use this map directory (map.xodr + derived/ground/ground-mesh.bin) instead of the installed map found by content
--cache-root DIR		Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps
--out FILE		Write the canonical timeline here (.gz compresses). Default: the workspace’s timeline/<sha256>.json; with —trace, nothing is written