Crash Investigator

Scope

• Detection: Monitors Mesen2 for pauses (breakpoints) or manual triggers.
• Data Capture: Retrieves CPU state (registers) and execution trace (PC history).
• Analysis: Resolves raw addresses to symbols and source lines using z3ed.
• Reporting: Generates Markdown reports ready for LLM consumption.

Core Capabilities

1. Manual Dump

Trigger an immediate analysis of the current state.

• dump: "I just saw a crash, analyze it."

2. Monitoring (The Sentinel)

Run in background to catch intermittent crashes.

• monitor: Polls emulator state. If it pauses (hit breakpoint/crash), auto-dumps.