sootsim debug
Toggle engine debug channels, capture snapshots, and diff internal state from the terminal while targeting any connected sootsim session.
terminal
Options
| flag | description |
|---|---|
--session <session-id> | target a specific connected session |
--port <number> | bridge port (defaults to 7668) |
--json | emit compact JSON for machine consumption |
--pretty | emit formatted JSON for human inspection |
Examples
terminal
What Debug Owns
debug is for engine state, not user-facing UI summaries. It owns:
- channel toggles like
sheets,portals,touch, andrender - snapshots and diffs
- recent event history
- on-demand inspectors for complex runtime structures
If you want to know what is on screen, use inspect. If you want to know what the engine thinks just happened, use debug.