Erste Schritte

Diese Seite führt von einer fertigen Installation zur ersten Analyse. Falls RHEXA noch nicht installiert ist, beginnen Sie mit der Installation.

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

1. Installation prüfen

rhexa doctor

Die Prüfung meldet unter anderem, ob die Engine gefunden wird (ghidra, ghidra-version) und ob ein passendes JDK vorhanden ist. Optionale Werkzeuge wie Hopper, IDA oder jadx dürfen fehlen.

2. Den Agenten fragen

Ist RHEXA in Ihrem Agenten registriert (siehe Agent anbinden), starten Sie den Agenten in einem beliebigen Verzeichnis und stellen eine konkrete Frage, zum Beispiel:

Analysiere /home/ich/proben/license. Welche Funktion prüft den Lizenzschlüssel,
und gegen welche Konstante? Zeig mir die Belege.

Der Agent öffnet das Programm mit open_binary, lässt die Rhexa Engine analysieren, liest gezielt Zeichenketten, Funktionen und Pseudocode und antwortet mit Adresse, Konstante und Fundstelle.

3. Dasselbe auf der Kommandozeile

Alle Analysen gibt es auch ohne Agenten. Ersetzen Sie Pfad, Suchtext und Funktion durch Ihr Ziel:

rhexa analyze  /pfad/zum/programm --provider ghidra --json
rhexa search   /pfad/zum/programm "license" --provider ghidra --json
rhexa function /pfad/zum/programm main --provider ghidra --json
rhexa decompile /pfad/zum/programm 0x401000 --provider ghidra --json

--json liefert das vollständige Ergebnis mit Belegen. rhexa --help und rhexa <befehl> --help zeigen alle Optionen.

4. Wie geht es weiter?

Konzepte wie Sitzung, Evidence und Snapshot erklärt das Benutzerhandbuch.
Für längere Untersuchungen lohnen sich Snapshots.
Bei Problemen hilft Fehlersuche.