Ghidrust provides a hyper fast, AI native reverse engineering platform built in Rust, inspired by Ghidra. Includes experimental GPU kernels to rapidly decompile large files, a decryption suite, and network monitor for packet to binary reverse engineering.
Ghidrust — agent skill
What Ghidrust is
Ghidrust is a Rust reverse-engineering toolkit inspired by — not a fork. It loads PE/ELF (and raw blobs), disassembles x86-64 (bounded by function end by default), creates/heals functions, runs Auto Analysis, decompiles to pseudo-C, parses IL2CPP metadata / touch-maps / Unity install inventory, spills large analysis artifacts, inventories PE installs, queries RTTI catalogs, and (on Windows) attaches read-only to live processes — via CLI, MCP (stdio), and an egui -style GUI. The skill file is also embedded in the agent crate so Start works without a source-tree checkout.
Aims: a freestanding, auditable RE core; CPU-correct analysis first; optional experimental GPU bulk scan + VRAM-resident decompile; agent-friendly headless use.
Experimental GPU: wgpu/Vulkan kernels for bulk RE and multipass decompile (.gdecomp). Correctness vs CPU is the bar; wall-clock speedups are not guaranteed on small binaries. See docs/GPU_DECOMPILER_RESEARCH.md.
Build and smoke-test
From the repo root (Rust stable):
cargo build --workspace --release
./target/release/ghidrust help
./target/release/ghidrust load fixtures/tiny_x64.pe
./target/release/ghidrust disasm fixtures/tiny_x64.pe --count 16
./target/release/ghidrust function create fixtures/tiny_x64.pe --addr 0x140001000 --json
./target/release/ghidrust decompile fixtures/tiny_x64.pe --addr 0x140001000 --json
./target/release/ghidrust inventory fixtures --max-depth 2 --json
./target/release/ghidrust tree fixtures --ext pe,dat --json
./target/release/ghidrust artifact list --json
./target/release/ghidrust il2cpp meta fixtures/il2cpp/meta_v31.dat --filter Camera --json
./target/release/ghidrust il2cpp touch-map --meta fixtures/il2cpp/meta_v31.dat --filter Camera --json
./target/release/ghidrust il2cpp stubs --binary fixtures/il2cpp/il2cpp_stub_lab.pe --json
./target/release/ghidrust gpu-decompile fixtures/tiny_x64.pe --out entry.gdecomp --json
cargo run -p ghidrust-gui --release
Windows: .\target\release\ghidrust.exe / .\target\release\ghidrust-gui.exe. Friction surfaces (inventory, tree, artifact, process, rtti --filter) match MCP tool names in tool_defs() — see SKILL.md.
Check build identity: ghidrust --version (same package version as MCP server_info and egui About). Agents need MCP tool_surface >= 3 (touch-map / body_class / function_create); prefer >= 4 for bounded disasm / get_calls_from; >= 5 for decode tools; >= 6 for crypto recover/bake; >= 7 for live process debug; >= 8 for Ghidnet (net_*, net_rules_update, server_info.network; see ghidnet.md). Restart MCP after rebuild if those tools are missing.
Ghidnet / ET Open smoke (IDS alerts, not kernel IPS):
./target/release/ghidrust net help
./target/release/ghidrust net rules update et-open --from-archive fixtures/et-open-mini.tar.gz --et-version mini --json
./target/release/ghidrust net rules list --json
./target/release/ghidrust net detect --payload-file fixtures/et-http-gate.bin --json
Smoke crypto surfaces:
./target/release/ghidrust crypt-constants fixtures/analysis_lab.pe --json
./target/release/ghidrust recover-strings fixtures/analysis_lab.pe --json
./target/release/ghidrust crypto-capabilities fixtures/analysis_lab.pe --json
./target/release/ghidrust decode bake -b64 SGVsbG8= -op FromBase64 --json
./target/release/ghidrust decode magic -b64 SGVsbG8= -depth 3 --crib Hello --json
./target/release/ghidrust decode bake -path fixtures/analysis_lab.pe -addr 0x140001000 -op Gunzip --annotate-va 0x140001000 --json
Crypto how-to
Run the four tiers in order: Find Crypt, recovered strings, capability matching, then explicit or automatic recipe decoding.
./target/release/ghidrust analyze PATH --analyzer "Find Crypt" --json
./target/release/ghidrust crypt-constants PATH --algo AES --json
./target/release/ghidrust recover-strings PATH --only stack,tight,decoded --json
./target/release/ghidrust crypto-capabilities PATH --tag decrypt --json
./target/release/ghidrust decode bake -b64 SGVsbG8= -op FromBase64 --json
./target/release/ghidrust decode bake -hex CIPHERTEXT -op RC4 -key-hex KEY --json
./target/release/ghidrust decode magic -b64 SGVsbG8= -depth 3 -crib Hello --json
For agent calls, use crypt_constants, recover_strings, list_crypto_capabilities, decode_bake, and decode_magic. AES-GCM returns only the unauthenticated counter-mode plaintext path; it does not verify a tag. The living coverage matrix is decrypt-feature-test-log.md.
MCP for agents (register in Cursor / Claude Desktop / other MCP clients — see root README):
./target/release/ghidrust mcp
Skill install
Canonical skill file: SKILL.md. Point any skill-aware agent at it, or copy it into that tool’s skills directory:
| Agent / tool | Typical location |
|---|---|
| Cursor | project or user skills / rules (see Cursor docs) |
| Grok (GUI Start / project open) | <project>/.grok/skills/ghidrust/SKILL.md (auto-written from embedded skill) |
| Grok (manual / user-global) | ~/.grok/skills/ghidrust/ |
| MCP clients | register ghidrust mcp as a stdio server |
# example: copy into a local skills dir
mkdir -p .skills/ghidrust
cp skill/SKILL.md .skills/ghidrust/SKILL.md
New-Item -ItemType Directory -Force .skills\ghidrust | Out-Null
Copy-Item skill\SKILL.md .skills\ghidrust\SKILL.md -Force
Slash command where supported: /ghidrust. Keep installed copies in sync with this SKILL.md when editing.