Skip to content
Back to search

windiff

Tool that allows comparing symbol, type and syscall information of Microsoft Windows binaries across different versions of the OS, using a Web UI and/or LLMs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ergrelet/windiff with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ergrelet/windiff'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ergrelet--windiff/badge.svg)](/listings/ergrelet--windiff)

HTML

<a href="/listings/ergrelet--windiff"><img src="/api/listings/ergrelet--windiff/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 135 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # WinDiff
  2. ## About
  3. WinDiff is an open-source web-based tool that allows browsing and comparing
  4. symbol, type and syscall information of Microsoft Windows binaries across
  5. different versions of the operating system. The binary database is automatically
  6. updated to include information from the latest Windows updates (including
  7. Insider Preview).
  8. It was inspired by [ntdiff](https://github.com/ntdiff/ntdiff) and made possible
  9. with the help of [Winbindex](https://github.com/m417z/winbindex).
  10. ## Screenshot
  11. <img src="./docs/static/windiff_screenshot.png" alt="Screenshot of WinDiff">
  12. ## How It Works
  13. WinDiff is made of two parts: a CLI tool written in Rust and a web frontend
  14. written in TypeScript using the Next.js framework.
  15. The CLI tool is used to generate compressed JSON databases out of a
  16. configuration file and relies on `Winbindex` to find and download the required
  17. PEs (and PDBs). Types are reconstructed using `resym`. The idea behind the CLI
  18. tool is to be able to easily update and regenerate databases as new versions of
  19. Windows are released. The CLI tool's code is in the `windiff_cli` directory.
  20. The frontend is used to visualize the data generated by the CLI tool, in a
  21. user-friendly way. The frontend follows the same principle as `ntdiff`, as it
  22. allows browsing information extracted from official Microsoft PEs and PDBs for
  23. certain versions of Microsoft Windows and also allows comparing this information
  24. between versions. The frontend's code is in the `windiff_frontend` directory.
  25. A scheduled GitHub action fetches new updates from `Winbindex` every day and
  26. updates the configuration file used to generate the live version of WinDiff.
  27. Currently, because of (free plans) storage and compute limitations, **only KB**
  28. **and Insider Preview updates less than one year old are kept** for the live
  29. version. You can of course rebuild a local version of WinDiff yourself, without
  30. those limitations if you need to. See the next section for that.
  31. Note: `Winbindex` doesn't provide unique download links for 100% of the indexed
  32. files, so it might happen that some PEs' information are unavailable in WinDiff
  33. because of that. However, as soon as these PEs are on VirusTotal, `Winbindex`
  34. will be able to provide unique download links for them and they will then be
  35. integrated into WinDiff automatically.
  36. ## How to Build
  37. ### Prerequisites
  38. - Rust 1.85 or superior
  39. - Node.js 20.9 or superior
  40. ### Command-Line
  41. The full build of WinDiff is "self-documented" in `ci/build_frontend.sh`, which
  42. is the build script used to build the live version of WinDiff. Here's what's inside:
  43. ```bash
  44. # Resolve the project's root folder
  45. PROJECT_ROOT=$(git rev-parse --show-toplevel)
  46. # Generate databases
  47. cd "$PROJECT_ROOT/windiff_cli"
  48. cargo run --release "$PROJECT_ROOT/ci/db_configuration.json" "$PROJECT_ROOT/windiff_frontend/public/"
  49. # Build the frontend
  50. cd "$PROJECT_ROOT/windiff_frontend"
  51. npm ci
  52. npm run build
  53. ```
  54. The configuration file used to generate the data for the live version of WinDiff
  55. is located here: `ci/db_configuration.json`, but you can customize it or use
  56. your own. PRs aimed at adding new binaries to track in the live configuration
  57. are welcome.
  58. ## Security Research Agent Skill
  59. The repository ships an [Agent Skill](https://agentskills.io/) that turns
  60. WinDiff into an automated security-research assistant. Instead of clicking
  61. through the diff UI yourself, you can ask
  62. [Claude Code](https://code.claude.com/docs/en/skills) or
  63. [Codex](https://learn.chatgpt.com/docs/build-skills) to compare two Windows
  64. versions and write up what changed — and *why it matters*.
  65. The canonical skill lives in `skills/windiff-version-diff-analysis/`. Discovery
  66. aliases under `.claude/skills/` and `.agents/skills/` make the same files
  67. available to both harnesses without maintaining duplicate copies. When you open
  68. this repo in either harness, the skill loads automatically and triggers on
  69. requests like:
  70. - "Diff `ntoskrnl.exe` between 21H2 and 24H2 and tell me what's new."
  71. - "What new syscalls or process mitigations appeared in this Windows update?"
  72. - "What changed in `win32k.sys` / `ci.dll` that matters for EDR or anti-cheat?"
  73. Given two versions, the skill drives `windiff_cli` to generate the databases,
  74. diffs them, and produces a report that interprets the raw symbol/type/syscall
  75. delta using Windows-internals knowledge (API prefixes, component roles), framed
  76. for three audiences: **anti-malware/EDR developers**, **anti-cheat developers**,
  77. and **vulnerability researchers**. It highlights new syscalls, new mitigation
  78. flags (including bits hidden inside anonymous bitfield structs, linked back to
  79. their parent like `_EPROCESS::MitigationFlags2Values`), new ETW/threat-intel
  80. telemetry and kernel callbacks, code-integrity changes, and brand-new components.
  81. Here's a report generated by Claude Opus 4.7 for the prompt "Diff ntoskrnl.exe
  82. between 25H2 and 26H1 and tell me what's new. Write your report in a markdown
  83. file":
  84. [ntoskrnl_25H2_to_26H1.md](./docs/claude_report_example/ntoskrnl_25H2_to_26H1.md)
  85. For curated base-version diff documentation, see the [Windows 10 version-diff
  86. series](./docs/windows10-base-version-diffs/README.md) and the [Windows 11
  87. version-diff series](./docs/windows11-base-version-diffs/README.md).
  88. ### Using the diff helper without an agent
  89. The skill's core diff logic is a standalone Python script with no dependencies,
  90. usable on its own against any databases produced by `windiff_cli`:
  91. ```bash
  92. SKILL_DIR=skills/windiff-version-diff-analysis
  93. # List the OS versions / binaries available in a database directory
  94. python3 "$SKILL_DIR/scripts/windiff_diff.py" \
  95. windiff_frontend/public --list
  96. # Diff one binary between two OS versions ("version_update_architecture" suffixes)
  97. python3 "$SKILL_DIR/scripts/windiff_diff.py" \
  98. windiff_frontend/public ntoskrnl.exe 21H2_BASE_amd64 22H2_BASE_amd64
  99. ```
  100. It prints a human-readable summary to stderr and structured JSON (added/removed
  101. exports, symbols, modules, syscalls, and resolved type/bitfield changes) to
  102. stdout. See the skill's `SKILL.md` for the full workflow and reference material.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.