sootsim debug

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

terminal

sootsim debug <subcommand> [args]

Options

flagdescription
--session <session-id>target a specific connected session
--port <number>bridge port (defaults to 7668)
--jsonemit compact JSON for machine consumption
--prettyemit formatted JSON for human inspection

Examples

terminal

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.