Windows & .NET reverse engineering workflows, a local CLI, and a Codex skill — with evidence you can trace.
Reverse Workbench turns local EXE/DLL files, .NET assemblies, and UTF-8 decompiler exports into structured analysis cases. Select a managed type or a native function VA, inspect the evidence, and reuse a completed case only after its identity and artifacts pass integrity checks.
The analysis engines are REA and optional Ghidra. This project adds input validation, capability routing, a versioned adapter, evidence reports, and case recovery. It does not claim to have authored those engines.
Install Node 24.11+ within major version 24 and Git, then run:
git clone https://github.com/bingxijun/reverse-engineering-workbench.git
cd reverse-engineering-workbench
node bin/reverse-workbench.mjs import-text samples/export-example.txt --out output/first-reportOpen output/first-report/report.md. This imports supplied text with line numbers and a file digest; it does not establish the original binary's identity.
The self-authored demo also needs .NET SDK 10 to build. Analyzing an existing assembly does not require building the sample.
npm run setup:rea
node bin/reverse-workbench.mjs doctor --json
dotnet build samples/managed/Example.csproj -c Release
node bin/reverse-workbench.mjs inspect samples/managed/bin/Release/net10.0/Example.dll --type ReverseWorkbench.Sample.Calculator --out output/managed-demoThe report distinguishes PE x86 from managed AnyCPU, locates Calculator.Add, and retains its CIL opcode evidence. It does not decompile managed code to C# or execute the assembly. REA 6.5.0 is installed locally from a committed lockfile with installation scripts disabled.
| Task | Command / behavior |
|---|---|
| Check available tools | doctor --json reports managed and native capabilities separately |
| Get an overview | inspect FILE --out NEW_DIRECTORY |
| Select a .NET type | Add --type Namespace.Type |
| Inspect a native function | Add --function-va 0x180001000; requires configured Ghidra |
| Import an export | import-text FILE --out NEW_DIRECTORY; UTF-8, up to 8 MiB / 100000 lines |
| Reuse a completed case | Repeat the same command with --resume; verified hashes and versions must match |
--type and --function-va are mutually exclusive. Addresses are exact hexadecimal VAs, not RVAs or file offsets. The example address belongs to our native fixture; do not copy it to an unrelated binary.
- Content-based routing: a
.dllextension cannot turn arbitrary bytes into a PE file. - Explicit uncertainty: unsupported inputs, missing tools, unmatched types, and partial coverage remain distinct.
- Traceable findings: evidence IDs lead to source lines or JSON Pointers in retained backend output.
- Original raw bytes: stdout/stderr are preserved before decoding and recorded with SHA-256 digests.
- Reliable reuse: target content, query, adapter/schema version, backend identity, and artifact hashes gate cache reuse.
- Agent guidance: the Windows reverse skill turns a question into a supported operation, evidence, and remaining unknowns.
Hashes detect accidental corruption; they are not signatures or a sandbox. See architecture and walkthrough.
Extract Ghidra 12.1.x and a full 64-bit JDK 21+, then configure the shell running the CLI:
$env:GHIDRA_INSTALL_DIR='C:\tools\ghidra_12.1.4_PUBLIC'
$env:JAVA_HOME='C:\tools\jdk-21'
node bin/reverse-workbench.mjs doctor --json
node bin/reverse-workbench.mjs inspect 'C:\samples\example.dll' --function-va 0x180001000 --out output/native-demoWindows native support follows REA's experimental P0 restrictions: Windows 10+ x64, fixed local NTFS paths, native x86/x64 PE. Ghidra 12.1.4 was tested locally with our x64 DLL. Dynamic debugging, automatic unpacking, and arbitrary hostile-target analysis are outside this release.
The skill and CLI are separate. Keep this repository available, and copy skills/windows-reverse into your Codex skills directory (default ~/.codex/skills). If the destination exists, compare it before replacing it. Tell Codex the repository location when invoking the skill.
Example request:
Use windows-reverse from this repository. Inspect Example.dll, focus on ReverseWorkbench.Sample.Calculator, and explain Add using evidence IDs. Save a new case under output/calculator.
The CLI works independently of an AI client. Other clients may load the SKILL.md format, but client-specific integration beyond Codex has not been verified.
Local v0.1.0 validation: 51 automated tests and 7 real workflow checks passed on Windows x64. Real checks cover .NET overview, type selection, unmatched selection, verified resume, native overview, and two native functions. Environment, hashes, and limitations · Machine-readable record
npm test
node scripts/verify-real.mjs
node scripts/benchmark.mjs output/verification/latest.jsonBuild the samples and configure tools before real verification. Missing prerequisites are skipped, not passed. The Actions badge reports remote CI separately; it does not certify native Ghidra validation. No cross-project performance or quality advantage has been measured.
- Usage guide and editable diagrams
- Chinese command reference and troubleshooting
- Japanese introduction and usage
- Contributing · Changes
- Contribution boundaries · Design decisions
Acknowledgments: P4nda0s/reverse-skills and zhaoxuya520/reverse-skill informed workflow research. morluto/rea supplies the external analysis interface. The core was developed with Codex assistance; upstream code was not copied into it. References are not claims of affiliation or endorsement.
MIT covers this project. Upstream distributions retain their own licenses and notices: third-party notices · pinned provenance.
