sootsim debug

Toggle engine debug channels, capture snapshots, and diff internal state from the terminal while targeting any connected sim.

sootsim debug <subcommand> [args]

#Options

#Examples

sootsim debug enable sheets,portals
sootsim debug snapshot before
sootsim debug diff before after
sootsim debug recent portals 20

#What Debug Owns

debug is for engine state, not user-facing UI summaries. It owns:

• channel toggles like sheets, portals, touch, and render
• 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.

#Related

• inspect
• open
• what-happened