| name | state-diff |
| description | Compare two state snapshots to identify register and memory changes between two points in time |
| allowed-tools | Bash, Read |
state-diff
Compare two debuggee state snapshots and produce a detailed change analysis — which registers changed, which memory regions were modified, and what the changes mean.
Instructions
Follow these steps exactly:
1. Identify snapshots
List the available snapshots:
dir "${CLAUDE_PLUGIN_ROOT}\snapshots"
If there are fewer than two snapshots, tell the user they need at least two snapshots (captured via /state-snapshot) and stop.
If the user specified two snapshot paths, use those directly. Otherwise, present the available snapshots and ask the user to pick the before (earlier) and after (later) snapshots.
2. Run the diff script
Execute the diff engine:
python "${CLAUDE_PLUGIN_ROOT}\skills\state-diff\state_diff.py" --before <before_snapshot_dir> --after <after_snapshot_dir>
The script writes diff_report.json into the after-snapshot directory by default. If the user specified a custom output path, pass --output <path>.
3. Read the report
Use Read to load the generated diff_report.json.
4. Analyze and reason
Interpret the diff report for the user: