Command families
| Family | Purpose |
|---|---|
fastsim config ... |
validate, expand, explain, diff, lock, and verify-lock |
fastsim plugins ... |
list/inspect compiled instances without import, or diagnose selected factories |
fastsim run ... |
launch an Application from a compiled Plan |
fastsim outputs ... |
discover, inspect, open, or clean artifacts under a trusted root |
fastsim settings ... |
manage strictly optional user settings |
Automation and CI should consume --json plus process exit status. Human-oriented colored output is not a protocol.
bash
fastsim config validate run.yaml --json
fastsim config expand run.yaml
fastsim config explain run.yaml scenario.scene.robots.arm.use
fastsim config lock run.yaml --output run.lock --json
plugins list and plugins inspect read compiled metadata without importing plugin code. plugins diagnose imports only factories selected by the Run to isolate packaging, entry-point, or contract failures.
Output operations remain inside the resolved trusted root. Inspect before cleanup, and never use a user home, project root, or unresolved environment variable as a recursive target. Staging, validation, atomic publication, and failure cleanup protect output integrity.