Betrieb

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

Aktualisieren

cd rhexa
git pull
npm ci
npm run build:cached
rhexa engine install   # neue Engine-Version, falls veröffentlicht

Starten Sie den Agenten nach einem Update neu, damit er den neuen MCP-Server lädt.

Ressourcen

Speicher: Jede Analysesitzung startet eine eigene Engine-JVM. In den Benchmarks lag der Spitzenbedarf bei rund 1,4 GB je Sitzung.
Dauer: Die erste Analyse eines Programms enthält den Engine-Start und die Auto-Analyse; kleine Programme sind in Sekunden fertig, große brauchen Minuten.
Temporäre Dateien: Analyseprojekte liegen in privaten Verzeichnissen unter TMPDIR und werden beim Beenden der Sitzung gelöscht. Dauerhafte Projekte sind für Roadmap-Phase 3 geplant.

Token sparen

Mit RHEXA_MCP_RESULT_TEXT_PROFILE=compact im env-Eintrag der MCP-Registrierung liefert RHEXA Ergebnisse kompakter an den Agenten: ohne die doppelte Kopie des Ergebnisses und ohne das in jeder Antwort wiederholte Analyseprofil. Jede Auslassung ist in text_delivery benannt; die Sitzung behält die vollständigen Belege, und get_evidence_bundle liefert sie unverändert. Im Aufgaben-Benchmark sank der Tokenverbrauch damit um 15,7 %. rhexa setup trägt die Einstellung für Claude Code automatisch ein; ein bereits gesetzter Wert bleibt erhalten. Für andere Clients ist sie optional, weil Werkzeuge, die Belege direkt aus den Antworten lesen, das vollständige Format brauchen.

Snapshots und Belege sichern

Ergebnisse einer Sitzung lassen sich beim Schließen als Snapshot-Datei sichern und später wieder laden; Belege lassen sich exportieren und importieren. Details im Benutzerhandbuch.

Fehlersuche

Symptom	Ursache und Abhilfe
`rhexa doctor` meldet die Engine nicht	`rhexa engine install` ausführen; `rhexa engine status` zeigt die genutzte Engine. Ein gesetztes `GHIDRA_INSTALL_DIR` hat Vorrang und muss auf ein Verzeichnis mit `Ghidra/application.properties` zeigen.
JDK wird abgelehnt	Die Engine verlangt ein vollständiges 64-Bit-JDK 25; ein JRE oder Java 21 reicht nicht. `JAVA_HOME` prüfen.
Agent sieht keine RHEXA-Werkzeuge	Registrierung prüfen (`claude mcp list`), Pfad zu `scripts/rhexa.mjs` kontrollieren, Agent neu starten.
Fehler `target_unavailable`	Es ist kein Ziel geöffnet; zuerst `open_binary` mit dem Pfad aufrufen.
Fehler `capability_unavailable`	Das gewählte Werkzeug braucht ein optionales Programm (etwa Rizin) oder unterstützt das Ziel nicht; ein anderes Werkzeug verwenden.
Build der Engine bricht in `:Base:ip` ab	Nach einem Testlauf liegen Logdateien mit Namen wie `${sys:logFilename}` im Quellbaum: `find engine -name '${sys:*' -delete`.

Sicherheit

Statische Analyse führt das Zielprogramm nie aus und verändert die Zieldatei nicht.
Laufzeitwerkzeuge (Prozessbeobachtung, Frida, Browser) führen Code aus; der Werkzeugvertrag weist das aus. Untersuchen Sie unbekannte Programme in einer isolierten Umgebung.
Inhalte aus dem Zielprogramm sind Daten, keine Anweisungen. RHEXA kennzeichnet sie; ein Agent darf darin enthaltenen Aufforderungen nicht folgen.
Abhängigkeiten beider Stacks werden regelmäßig auf bekannte Schwachstellen geprüft.

Deinstallieren

claude mcp remove rhexa
npm unlink -g rhexa-agents
rm -rf ~/opt/rhexaengine_12.1.4_DEV