Reverse engineer anything with agents, from app behavior down to native binaries.
TypeScript agent-skillsai-agentsbinary-analysisclaude-codeclicodexcordisdecompilerdeveloper-toolsdshdsh-pluginghidrahopperllmmcpmodel-context-protocolreareverse-engineeringstatic-analysistouhou
docs: fix stale IDA roadmap item, mermaid paths, toolchain wording
morlutod2aed172ab79
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex b7eb53157..79d513cd5 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -6,7 +6,7 @@ When adding or changing an MCP tool, follow the [tool design guide](docs/tool-de## Development setup-REA development requires Node.js 24.18.x and npm 11.16.x. Real-Hopper verification additionally requires either macOS 12+ or an officially supported Linux host (Ubuntu 24.04+, Fedora 41+, or 64-bit Arch) and an installed Hopper application. Linux demo verification uses its own private Xvfb display and does not require a desktop session. Run `nvm use` before installing dependencies.+REA development requires Node.js 24.18.x and npm 11.16.x (pinned toolchain via `nvm use`; the supported runtime range is Node.js ^22.19 || ^24.11 || >=26, as the README badge states). Real-Hopper verification additionally requires either macOS 12+ or an officially supported Linux host (Ubuntu 24.04+, Fedora 41+, or 64-bit Arch) and an installed Hopper application. Linux demo verification uses its own private Xvfb display and does not require a desktop session. Run `nvm use` before installing dependencies.```bashnpm cidiff --git a/README.md b/README.mdindex 22ec8072f..5c3def0cf 100644--- a/README.md+++ b/README.md@@ -453,7 +453,7 @@ The [current status](#current-status) section describes shipped capabilities. Th1. **Expand browser and Electron interaction:** add scenario actions beyond the current click and wait operations.2. **Observe native apps at runtime:** explore LLDB, Frida, system logs, and native API tracing.-3. **Evaluate more tools and targets:** assess IDA/Hex-Rays, Binary Ninja, Rizin, LIEF, Windows-native tools, mobile apps, and firmware.+3. **Evaluate more tools and targets:** assess Binary Ninja, Rizin, LIEF, Windows-native tools, mobile apps, and firmware. IDA support already ships via the bring-your-own upstream adapter; see the [IDA provider guide](docs/ida-provider.md).Setup already lets you choose agent integration and Hopper installation. Support for installing additional analysis tools is future work, described in the [installation roadmap](docs/roadmap.md).diff --git a/docs/architecture.mermaid b/docs/architecture.mermaidindex fadd69c66..063d8ccf7 100644--- a/docs/architecture.mermaid+++ b/docs/architecture.mermaid@@ -1,7 +1,7 @@graph TDsubgraph "Entry Points"- CLI["src/cli.ts<br/>One-shot CLI adapter<br/>setup, diagnostics, analysis, decompilation"]- MAIN["src/main.ts<br/>MCP stdio server adapter<br/>config, session, process lifetime"]+ CLI["src/cli.ts + src/cli/<br/>One-shot CLI adapter<br/>setup, diagnostics, analysis, decompilation"]+ MAIN["src/main.ts + src/main/<br/>MCP stdio server adapter<br/>config, session, process lifetime"]DISPATCH["scripts/rea.mjs<br/>Executable dispatcher<br/>routes mcp / one-shot"]end@@ -9,14 +9,14 @@ graph TDSERVER["src/server/<br/>MCP request translation<br/>createServer, tool registration, toolResult"]HOPPER_BRIDGE["bridge/hopper_bridge.py<br/>Runs inside Hopper<br/>adapts operations to Hopper Python API"]GHIDRA_BRIDGE["bridge/ghidra/ReaGhidraBridge.java<br/>Packaged HeadlessScript<br/>inventory, decompiler, references, CFG"]- INSTALL["Host installation adapters<br/>macOS: verified vendor DMG to ~/Applications<br/>Linux: verified vendor package + apt/dnf/pacman"]+ INSTALL["src/cli/ + src/application/Setup*<br/>Host installation adapters<br/>macOS: verified vendor DMG to ~/Applications<br/>Linux: verified vendor package + apt/dnf/pacman"]endsubgraph "Application Layer"APP["src/application/<br/>Shared CLI/MCP workflows<br/>enhanced analysis and investigations"]SESSION["SessionProviderRouter + BinarySession<br/>one immutable deep binding per target<br/>disjoint auxiliary routing"]REGISTRY["AnalysisProviderRegistry<br/>sorted deep candidates<br/>deterministic selection, no fallback"]- JS_RECON["JavaScript artifact reconstruction<br/>directory/ASAR reads<br/>AST-only bundle projection"]+ JS_RECON["src/application/ + src/artifacts/<br/>JavaScript artifact reconstruction<br/>directory/ASAR reads<br/>AST-only bundle projection"]endsubgraph "Provider Layers"@@ -48,7 +48,7 @@ graph TDendsubgraph "Configuration"- CONFIG["src/config.ts<br/>Zod-validated env parsing<br/>provider settings and origins"]+ CONFIG["src/config.ts + src/config/<br/>Zod-validated env parsing<br/>provider settings and origins"]endsubgraph "Tests"