# reverify einrichten — Anleitung für deinen Coding-Agenten

> **So benutzt du diese Datei:** Leg sie in dein Projektverzeichnis und sag
> deinem Agenten: *„Halte dich an reverify-einrichten.md."* Das funktioniert mit Claude
> Code, Codex, Cursor, Cline und allem anderen, was Dateien lesen kann.
> Wenn dein Agent von selbst eine bestimmte Datei liest, kannst du sie auch
> in `AGENTS.md` umbenennen oder den Inhalt in deine `CLAUDE.md` kopieren.

**Projekt:** [github.com/2akouwu/reverify](https://github.com/2akouwu/reverify) · **Stand:** 2026-09-07 · Zusammengestellt von
[localdev.ai](https://localdev.ai/)

---

## Ziel

Reverify als Python-Paket installieren, CLI und MCP-Server lauffähig machen, ersten Verify-Loop gegen echte Bytes demonstrieren.

## Voraussetzungen

- Python 3.x (Version aus PyPI-Badge nicht spezifiziert, mind. 3.8+ wahrscheinlich)
- pip
- Optional: für [full] capstone+unicorn+lief braucht es C-Compiler und Build-Tools
- Optional: für [angr] zusätzliche Abhängigkeiten
- Optional: für MCP-Server-Betrieb Claude Code oder Cursor oder anderer MCP-Client

## Das fragst du mich, bevor du anfängst

- Willst du 'pip install reverify' (pure-Python core) oder 'pip install reverify[full]' (mit capstone, unicorn, lief)?
- Willst du auch 'pip install reverify[angr]' für die semantic layer (functions, calls, cross-references)?
- Hast du eine Beispiel-Binary (sample.bin, sample.exe) oder soll ich eine erstellen/downloaden?
- Willst du den MCP-Server testen oder nur CLI?
- Für 'reverify orchestrate' oder 'reverify rollover': hast du einen API-Key für Claude/OpenAI oder willst du den mock-driver nutzen?

## Einrichtung

### 1. Paket installieren

```bash
pip install reverify
# oder: pip install 'reverify[full]'
# oder: pip install 'reverify[angr]'
```

**Prüfen:** python -c "import reverify; print(reverify.__version__)" oder 'reverify --version' bzw. 'python reverify/cli.py --version' funktioniert

> ⚠️ [full] braucht C-Compiler; auf Windows ggf. Visual C++ Build Tools. [angr] ist sehr groß. Ohne [full] läuft nur pure-Python fallback.

### 2. Backends checken

```bash
reverify backends
```

**Prüfen:** Ausgabe zeigt welche Engines aktiv sind (capstone, unicorn, lief, angr, z3) oder 'pure-Python fallback'

> ⚠️ Wenn [full] nicht installiert: capstone/unicorn/lief fehlen, disasm/emulate/parse fallen auf langsameren pure-Python-Code zurück.

### 3. Erste CLI-Befehle testen

```bash
python reverify/cli.py auto sample.bin --json
# oder: reverify auto sample.bin --json
python reverify/cli.py disasm 90505831C0C3 --arch x86_64
# oder: reverify disasm 90505831C0C3 --arch x86_64
```

**Prüfen:** JSON-Output mit erkanntem Format/Architektur bzw. disassemblierten Mnemonics (push, pop, xor, ret)

> ⚠️ Ohne sample.bin schlägt 'auto' fehl — Dummy-Datei erstellen oder anderen Befehl wählen. 'disasm' braucht keine Datei, ist sicherster erster Test.

### 4. Verify-Loop testen

```bash
reverify verify - --claim '{"kind": "emulate_result", "code": "b805000000b90300000001c8c3", "arch": "x86", "expect_registers": {"eax": 8}}'
```

**Prüfen:** Output zeigt VERIFIED mit evidence (Register-Werte) oder REFUTED mit beobachteten Werten

> ⚠️ JSON muss korrekt escaped sein; in Shell ggf. single quotes um das JSON. Arch 'x86' vs 'x86_64' beachten.

### 5. MCP-Server starten

```bash
python reverify/mcp_server.py
```

**Prüfen:** Prozess läuft, gibt ggf. 'MCP server running' oder ähnliches aus; Port/Transport-Info in Ausgabe

> ⚠️ MCP-Server braucht einen MCP-Client (Claude Code, Cursor). Ohne Client ist der Server nutzlos. Nicht automatisch im Hintergrund starten ohne Nutzerbestätigung.


## Erster Test

Disassembly eines kurzen Hex-Strings ohne externe Datei — der sicherste erste Smoke-Test.

```python
reverify disasm 90505831C0C3 --arch x86_64 --json
```

## Wenn es klemmt

| Symptom | Ursache | Lösung |
|---|---|---|
| ImportError: No module named capstone / unicorn / lief | [full] extras nicht installiert oder C-Compilation fehlgeschlagen | Mit 'pip install reverify' (ohne [full]) testen — pure-Python fallback funktioniert. Oder Build-Tools installieren und 'pip install reverify[full]' erneut versuchen. |
| reverify: command not found | Script-Verzeichnis nicht in PATH oder Installation in venv vergessen | Stattdessen 'python reverify/cli.py ...' verwenden oder PATH prüfen. |
| JSON parse error bei --claim | Shell hat Quotes gefressen oder JSON ungültig | Claim in Datei schreiben und '--claims-file claim.json' verwenden. |
| INCONCLUSIVE bei semantic claims (function_at, calls, references) | angr nicht installiert ([angr] extra fehlt) | 'pip install reverify[angr]' — aber Achtung, angr ist groß. Oder akzeptieren dass pure fallback nur entry point und exports kennt. |
| MCP-Server startet aber Client findet keine Tools | MCP-Transport nicht konfiguriert (stdio vs sse vs websocket) | In Claude Code/Cursor MCP-Config prüfen; ggf. Transport-Flag oder Port in mcp_server.py prüfen. |

## Grenzen — das kann das Projekt nicht

- Reverse Engineering nur für autorisierte Binaries (eigene Software, Malware-Analyse, CTF, Interoperabilität)
- Semantic claims (functions, calls, cross-references) brauchen angr oder sind INCONCLUSIVE
- Disassembly/Emulation ohne [full] ist langsamer und weniger vollständig als capstone/unicorn
- Kein statischer Decompiler — nur Struktur, Disassembly, Emulation, Pattern-Matching
- Orchestrate/rollover brauchen API-Key oder mock-driver für LLM-Anbindung
- Kein eingebauter C-Compiler für candidate-code in behavior_equiv — externe Referenz nötig

## Regeln für dich als Agent

- Nie 'sudo pip install' ausführen — stattdessen venv oder user-install verwenden.
- Keine API-Keys oder Cloud-Credits ohne ausdrückliche Nutzerbestätigung verbrauchen.
- Vor 'reverify[full]' oder 'reverify[angr]' immer nachfragen — können Minuten dauern und Gigabytes an Speicher brauchen.
- Wenn ein Befehl fehlschlägt, nie einfach den nächsten ausführen — erst prüfen warum, dann fragen oder alternativen pure-Python-Befehl wählen.
- MCP-Server nicht automatisch im Hintergrund starten — Nutzer muss wissen, dass ein Server läuft.
- Bei 'verify' mit --claim immer JSON-Syntax prüfen; bei Zweifel '--claims-file' statt Inline-JSON verwenden.

---

### Wichtig

Diese Datei wurde aus der Liesmich-Datei des Projekts vom 2026-09-07
zusammengestellt und ist keine offizielle Dokumentation. Sie ersetzt nicht den
Blick in das Repository — wenn ein Befehl hier nicht funktioniert, gilt
[die Quelle](https://github.com/2akouwu/reverify), nicht diese Datei.

*Erklärvideos und Merkblätter zu Werkzeugen wie diesem:
[localdev.ai](https://localdev.ai/m/) — ohne Anmeldung.*
