fastsim outputs is the operator-facing index for files produced by Runs. It does
not start a simulator and does not maintain a database. Each command performs a
bounded scan of one explicit output root, ignores symlinks, and recognizes completed
.fsr files and transaction .incomplete files.
The root follows command line, environment, user setting, then the historical
./outputs default:
fastsim outputs root
fastsim outputs --output-root /data/fastsim list
Discovery and capacity
fastsim outputs list
fastsim outputs list --status complete --sort newest --limit 50
fastsim outputs list --verify --workers 8 --json
fastsim outputs stats
list --verify validates only the returned page and uses the bounded
compute.max_workers preference. Normal listing reads filesystem metadata only.
stats reports complete/incomplete counts, artifact bytes and filesystem capacity.
Inspect, verify and open
fastsim outputs inspect run-001/episode.fsr
fastsim outputs verify run-001/episode.fsr --json
fastsim outputs open run-001/episode.fsr
fastsim outputs open run-001/episode.fsr --no-browser --port 8080
fastsim outputs open run-001/episode.fsr --cache-dir /data/fsr-cache --cache-limit-gb 64 --workers 8
inspect, verify, and open lazily use the separately installed
fastsim-fsr-viewer. FastSim Core does not gain an FSR parser or camera-decoding
cost when these commands are unused. open forwards the configured Viewer cache
root, cache limit, and worker count.
A target may be a path relative to the selected root or an explicit absolute .fsr
path. Relative paths cannot escape the root. A bare filename is accepted only when
it uniquely identifies one bounded-scan result.
Cleanup
fastsim outputs remove run-001/episode.fsr --yes
fastsim outputs clean --older-than-hours 24 --yes
remove deletes exactly one named regular non-symlink artifact. clean can delete
only abandoned .incomplete transaction files older than the selected age. It
never deletes completed FSR files. Both commands require explicit confirmation.