Skip to content

Console Commands

DooDesch edited this page Jun 22, 2026 · 1 revision

Console Commands

All commands are namespaced snitch. Open the in-game developer console and type them. Everything is idle until snitch start.

Command What it does
snitch start Arm sampling and start streaming live data.
snitch stop Disarm sampling (the game keeps running).
snitch status One-line summary: active, fps, section/state/counter counts.
snitch frame Log the full frame-time distribution (mean/median/p95/p99/min/max, fps, GC).
snitch top [n] Log the top N sections by ms/frame (default 8).
snitch sections Log all sections.
snitch states [id] Log the entity-state distributions (optionally filtered).
snitch counters Log the registered numeric counters.
snitch hud [on|off] Toggle the on-screen overlay (or press F6).
snitch vanilla on|off Attribute CPU cost to vanilla hot paths (e.g. NPCMovement.Update/FixedUpdate).
snitch ablate <lever> Measure a subsystem's causal frame cost via an A/B toggle (built-in npc).
snitch levers List the available ablation levers.
snitch report [md|csv|all] Export a report to Mods/Snitch/runs/.

Notes

  • snitch vanilla on installs Harmony probes that aggregate one label across all instances (e.g. total NPCMovement.Update ms/frame). These are self-measured (only the methods Snitch wraps) - see How It Works.
  • snitch ablate npc toggles all NPC movement off and measures the settled frame-time delta. It runs host-only and is cleanest with other NPC mods (like Siesta) disabled.
  • Reports (snitch report) are written to Mods/Snitch/runs/ in your game folder as Markdown + CSV.

Clone this wiki locally