Installation

Entwicklungsstand: RHEXA ist noch nicht als Paket veröffentlicht. Installiert wird aus dem Quellcode. Befehl und MCP-Server heißen rhexa.

Voraussetzungen

Komponente	Version	Wofür
Betriebssystem	Linux x64 (getestet: Ubuntu 22.04, auch unter WSL2)	macOS und Windows folgen mit den Plattform-Prüfläufen
Node.js und npm	22.22.2+, 24.15+ oder 26+	Agentenschicht
JDK	25 (LTS), 64-Bit, vollständiges JDK	Rhexa Engine
Git, Python 3, GCC/Clang, make	aktuelle Versionen	Bauen von Agentenschicht und Engine
`ps` (procps)	Systempaket	Prozess-Besitzprüfung unter Linux

Optionale Werkzeuge wie ein Chrome-Browser für Web-Analysen, jadx für Android oder Frida für Laufzeitbeobachtung werden nur für die jeweiligen Analysen gebraucht.

1. Agentenschicht installieren

git clone https://github.com/mjanda0815/reengineering.git rhexa
cd rhexa
npm ci
npm run build:cached
npm link        # stellt den Befehl "rhexa" bereit

Das Repository ist derzeit privat; für den Zugriff ist eine Freigabe nötig.

2. Rhexa Engine installieren

Voraussetzung ist ein 64-Bit-JDK 25, erreichbar über JAVA_HOME oder PATH. Dann lädt RHEXA die Engine selbst:

export JAVA_HOME=/pfad/zum/jdk-25
rhexa engine install

Der Befehl zeigt Download-Adresse, Größe, SHA-256 und Zielverzeichnis und fragt, bevor er etwas schreibt (--yes ohne Rückfrage, --dry-run nur der Plan). Er prüft Größe und Prüfsumme gegen das veröffentlichte Manifest und installiert nach ~/.local/share/rhexa/engine. Archive gibt es derzeit für Linux x86-64. rhexa engine status zeigt, welche Engine RHEXA nutzt, rhexa engine languages listet die Prozessorsprachen, die sie analysieren kann, rhexa engine remove entfernt sie.

Engine selbst bauen (Entwickler)

cd engine
./gradlew -I gradle/support/fetchDependencies.gradle
./gradlew buildGhidra
unzip build/dist/rhexaengine_*_linux_x86_64.zip -d ~/opt
export GHIDRA_INSTALL_DIR="$HOME/opt/rhexaengine_12.1.4_DEV"

GHIDRA_INSTALL_DIR hat Vorrang vor der installierten Engine.

3. Prüfen

rhexa doctor

4. Agent anbinden

RHEXA spricht das Model Context Protocol (MCP) und funktioniert mit MCP-fähigen Agenten. Für Claude Code registrieren Sie den Server so (Pfade anpassen):

claude mcp add --scope user rhexa \
  -e JAVA_HOME=/pfad/zum/jdk-25 \
  -- node /pfad/zu/rhexa/scripts/rhexa.mjs mcp

Die installierte Engine findet RHEXA selbst; ein Pfad zur Engine ist nicht nötig.

Andere Agenten erwarten einen Eintrag mit Befehl node und den Argumenten /pfad/zu/rhexa/scripts/rhexa.mjs mcp in ihrer MCP-Konfiguration.

Wichtig: rhexa setup registriert das npm-Paket rhexa-agents, das noch nicht veröffentlicht ist. Registrieren Sie RHEXA deshalb wie oben gezeigt. Eine Installation des Original-REA (rea, npm rea-agents) kann daneben bestehen bleiben.

Starten Sie den Agenten danach neu. Weiter geht es mit den ersten Schritten.