Skip to content

About

Windows & .NET reverse engineering workbench + Codex skill. REA/Ghidra static analysis, traceable evidence and verified resume. 逆向工程 · リバースエンジニアリング

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Reverse Engineering Workbench

Windows & .NET reverse engineering workflows, a local CLI, and a Codex skill — with evidence you can trace.

English · 简体中文 · 日本語

Tests License: MIT Node: 24.x

Reverse Workbench workflow: input, checks, REA or Ghidra analysis, traceable evidence, and verified resume

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.

Try it without an analysis engine

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-report

Open 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.

Analyze a .NET DLL

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-demo

The 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.

What you can do

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.

What makes the workflow useful

  • Content-based routing: a .dll extension 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.

Native Ghidra setup

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-demo

Windows 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.

Install the Codex skill

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.

Verification and scope

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.json

Build 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.

Documentation and contributing

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.

About

Windows & .NET reverse engineering workbench + Codex skill. REA/Ghidra static analysis, traceable evidence and verified resume. 逆向工程 · リバースエンジニアリング

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages