Lorsqu'une équipe d'architecture logicielle cherche à comprendre comment une application bureautique atteint une recherche locale inférieure à la milliseconde, quels canaux IPC un paquet Electron expose entre preload et le processus principal, ou comment un binaire propriétaire signe ses requêtes réseau, la difficulté vient rarement d'un manque de désassembleurs. La véritable perte de temps survient lors du transfert manuel de contexte entre les tables de symboles Ghidra, le pseudo-code Hopper, les arborescences JADX et les captures HAR. Ayant dépassé 466 000 étoiles sur GitHub, morluto/rea (REA — Reverse Engineer Anything) comble précisément ce fossé d'orchestration.
REA (rea-agents) est une interface en ligne de commande (CLI) et un serveur Model Context Protocol (MCP) open source (io.github.morluto/rea) publié sous licence MIT. Loin d'être un outil magique de clonage instantané, il connecte les agents de codage — Claude Code, Cursor, Codex, Gemini CLI — aux analyseurs statiques déterministes ainsi qu'aux moteurs professionnels tels que Ghidra, Hopper, IDA Pro, Kuna et JADX, en retournant des résultats étayés par des adresses, des références d'appels et des limites explicites.
Synthèse Exécutive et Points Clés d'Architecture
- Orchestration MCP Fondée sur la Preuve : REA inspecte localement les binaires natifs, les archives
.asaret les assemblages managés pour livrer graphes d'appels, pseudo-code et zones d'incertitude documentées en vue d'une réimplémentation propre. - Maîtrise Stricte de la Fenêtre de Contexte LLM : Grâce aux schémas d'entrée compacts, au budget optionnel de 4 096 octets pour les schémas de sortie (
REA_MCP_OUTPUT_SCHEMA_PROFILE=compact) et au plafond de flux de 4 Mio, REA évite toute saturation de jetons. - Exigence Zero-Trust pour les Éditeurs Logiciels : Les bundles clients Electron
.asar, lessource mapsoubliées et les routes IPC non validées étant désormais cartographiables en quelques minutes, la logique métier sensible doit impérativement rester côté serveur.
À mesure que les entreprises déploient des solutions d'intelligence artificielle d'entreprise et des chaînes d'agents autonomes, l'audit des binaires historiques et la maîtrise de la surface d'exposition client deviennent indissociables du développement logiciel sur mesure. Décryptons l'architecture v6.9.0 de REA, son déploiement CLI/CI et ses règles de défense.
1. Architecture Centrale : Un Pont MCP de Preuves Plutôt qu'un Décompilateur Isolé
Contrairement aux raccourcis viraux sur les réseaux sociaux, REA ne devine pas le code source original par hallucination statistique. Exécuté sur Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 en module ESM natif ("type": "module"), il traduit les questions d'investigation de l'agent en appels d'outils locaux vérifiables.

Gestion du Budget de Jetons et Compression des Schémas
Injecter un désassemblage brut directement dans un LLM sature immédiatement le contexte et dégrade la précision analytique. Selon la documentation officielle REA, trois garde-fous structurels protègent la session :
- Profil Compact des Schémas d'Entrée : Lors de
tools/list, REA expose des schémas d'entrée condensés pour réduire le coût en jetons à chaque tour tout en maintenant la validation canonique côté serveur. - Budget de 4 096 Octets sur les Schémas de Sortie : Les API de modèles ne lisant pas directement les schémas de sortie MCP, REA les omet par défaut et valide chaque charge utile en interne ;
REA_MCP_OUTPUT_SCHEMA_PROFILE=compactpermet de les publier sous une limite stricte de 4 096 octets. - Processus Workers Isolés et Plafond de 4 Mio : L'analyse des paquets JavaScript et web s'exécute dans des workers dédiés (
#javascript-analysis-workeret#web-bundle-analysis-worker), tandis que les fluxstdout/stderrsont plafonnés à 4 Mio.
2. Installation, Diagnostic des Moteurs et Contrôle Automatisé en CI/CD
REA s'utilise aussi bien en mode conversationnel via MCP qu'en ligne de commande directe. Sous Linux, l'exécution de Ghidra, JADX ou de l'analyse statique Electron requiert un utilitaire système ps compatible procps pour vérifier la propriété des processus.
Étape 1 : Enregistrement auprès de vos Agents IA
Depuis un répertoire de confiance extérieur au projet cible, avec Node.js 22.23.4+ installé :
# Détecte les agents installés, sauvegarde les configurations et enregistre le serveur MCP
npx rea-agents setup
# Optionnel : installation globale de la commande 'rea'
npm install --global rea-agents
# Vérification de l'état des moteurs (Ghidra, Hopper, IDA, JADX)
rea doctor --json
# Mise à jour vérifiée d'une installation globale
rea update
L'assistant détecte Claude Code, Cursor, Codex, Gemini CLI et Grok Build, présente les modifications proposées avec sauvegarde préalable, puis active le serveur MCP après validation. Redémarrez ensuite votre agent.
Étape 2 : Porte Qualité CI/CD contre les Fuites Electron et JavaScript
L'inspection statique JavaScript, Electron (.asar) et .NET lit les fichiers passivement sans exécuter l'application ni nécessiter de décompilateur natif. Ce module TypeScript bloque automatiquement un déploiement CI si une source map de production est détectée :
import { execFile } from "node:child_process";
import { promisify } from "node:util";
import path from "node:path";
const execFileAsync = promisify(execFile);
export interface ReaJsModuleFinding {
readonly modulePath: string;
readonly imports: readonly string[];
readonly ipcChannels: readonly string[];
readonly hasSourceMap: boolean;
}
export interface ReaJsAnalysisReport {
readonly targetPath: string;
readonly electronBoundaries: readonly string[];
readonly modules: readonly ReaJsModuleFinding[];
readonly limitations: readonly string[];
}
export async function runReaBundleExposureGate(
rawAppDirectory: string,
): Promise<{ passed: boolean; violations: string[]; report: ReaJsAnalysisReport }> {
const resolvedTarget = path.resolve(rawAppDirectory);
const { stdout } = await execFileAsync(
"npx",
["-y", "rea-agents@latest", "analyze-javascript-application", resolvedTarget, "--json"],
{
timeout: 120_000,
maxBuffer: 4 * 1024 * 1024,
windowsHide: true,
},
);
const report = JSON.parse(stdout) as ReaJsAnalysisReport;
const violations: string[] = [];
for (const mod of report.modules) {
if (mod.hasSourceMap) {
violations.push(`Source map exposée dans le bundle de production : ${mod.modulePath}`);
}
}
return {
passed: violations.length === 0,
violations,
report,
};
}
3. Cibles Supportées : De l'Analyse Statique aux Binaires Natifs et Environnements RL
La version v6.9.0 couvre plus de 30 formats binaires et d'exécution sous un contrat de preuve unifié :
A. Analyseurs Statiques Intégrés (Sans Moteur Externe)
- JavaScript, Web et Electron : Graphes de modules, routes, frontières
preload/IPC, modules natifs et auditrea audit-release-exposure. - Exécutables Compilés et Managés : Binaires Go (version du compilateur et modules intégrés), Rust (
cargo-auditable), assemblages.NET(instructions CIL), exécutables PyInstaller (CArchive) et binairesDeno compile. - Moteurs de Jeu, Modèles IA et Durcissement Binaire : Métadonnées Unity
IL2CPP(versions 24, 27, 29, 31 et 39), archives GodotPCK, en-têtesGGUFetsafetensors, objets GPU CUDA/HIP/PTX, certificats PEAuthenticode(PKCS#7/X.509) et protections ELF/PE/Mach-O (PIE,NX,RELRO,CFG).
B. Ponts vers les Décompilateurs Natifs
Pour le recouvrement du flot de contrôle et du pseudo-code C/C++, REA pilote localement Hopper (hopper_bridge.py), Ghidra (ReaGhidraBridge.java, incluant DOS 16 bits, MIPS et RISC-V), IDA Pro, Kuna, Cutter/Rizin et JEB (REA_JEB_MCP_URL), avec délais configurables via REA_GHIDRA_STARTUP_TIMEOUT_MS et REA_HOPPER_STARTUP_TIMEOUT_MS.
C. Android, Firmware, Captures Réseau et Environnements RL (AgentEnv)
REA s'interface avec JADX, ADB et Apktool pour Android (ainsi que inspect_apk_signature v1–v3.1), Binwalk / Unblob pour les firmwares, WABT pour WebAssembly (inspect_wasm_artifact) et evmole pour le bytecode EVM hors ligne. De plus, rea environment-build ./session.har ./my-env --name my-env --json convertit une capture HAR en environnement AgentEnv reproductible pour l'apprentissage par renforcement (RL) d'agents IA.
4. Matrice Comparative : Rétro-Ingénierie Classique vs. Orchestration REA
| Critère d'Évaluation | Rétro-Ingénierie Manuelle | Copier-Coller Brut vers un LLM | REA (MCP + Preuves Structurées) |
|---|---|---|---|
| Coordination Multi-Outils | Bascule manuelle entre Ghidra, JADX, HAR et éditeur hexa | Extraits partiels collés sans vision globale | Requêtes unifiées sur 30+ analyseurs via un seul serveur MCP |
| Maîtrise des Hallucinations | Très fiable mais limitée par la cadence humaine | Risque élevé d'invention sur les appels manquants | Chaque résultat inclut adresses, références et limitations explicites |
| Efficience Contextuelle | Non applicable | Saturation rapide de la fenêtre de jetons | Schémas compacts, budget 4 096 octets et plafond 4 Mio |
| Audit Electron / Bundles JS | Extraction manuelle .asar et scripts ad hoc | Échec sur les gros bundles minifiés | Workers isolés cartographiant modules, canaux IPC et exposition |
| Génération d'Environnements RL | Développement manuel de serveurs simulés | Non pris en charge | Export direct d'environnements AgentEnv depuis des traces HAR |
5. Études de Cas Vérifiées : DX-Ball, Pont IPC Notion et Reconstruction 16 Bits
Trois démonstrations documentées illustrent la précision de cette approche fondée sur la preuve :
- Calcul de Panoramique Audio DX-Ball : L'inspection des instructions x86 originales a permis de reconstruire en C une fonction validant 3 205 cas de test x86 d'origine et reproduisant à l'identique les 63 octets compilés.
- Pont Presse-Papiers de Notion Desktop : Traçage complet depuis l'API du
rendererElectron à traverspreloadetIPCjusqu'au processusmainpour documenter le format de presse-papiers enrichi. - Calculs Angulaires 16 Bits de TH04 (PC-98) : Récupération en C++ des calculs d'angles fixes et ciblés à partir d'instructions DOS 16 bits, vérifiée face à la sortie historique du compilateur.
6. Modèles de Prompts Prêts à l'Emploi pour vos Investigations REA
Une fois npx rea-agents setup exécuté, utilisez directement ces quatre prompts orientés preuves dans Claude Code, Cursor ou Gemini CLI. Pour découvrir comment le protocole MCP pilote également l'audit publicitaire automatisé, consultez notre Guide d'Intégration Claude et Meta Ads MCP.
# 1. Audit des Frontières Preload et IPC d'une Application Electron (.asar)
Utilise REA pour inspecter statiquement /chemin/absolu/app.asar.
Cartographie tous les canaux IPC exposés entre renderer, preload et ipcMain,
identifie les gestionnaires sans validation de schéma et liste les source maps exposées.
# 2. Reconstruction d'Algorithme sur Binaire Natif (Ghidra / Hopper)
Analyse /chemin/absolu/binaire avec REA pour localiser la fonction de signature ou compression.
Retourne les adresses de symboles, le graphe d'appels, le pseudo-code et les limitations,
puis écris un test de vérification propre en TypeScript.
# 3. Contrôle de Signature APK (v1-v3.1) et Flux Réseau Android
Exécute REA sur /chemin/absolu/application.apk pour vérifier les certificats via
inspect_apk_signature et tracer les classes clientes HTTPS/gRPC avec JADX.
# 4. Génération d'un Environnement AgentEnv (RL) depuis une Capture HAR
Utilise REA pour construire un environnement exécutable AgentEnv depuis ./session.har
vers ./mon-env et indique quelles opérations d'état sont confirmées par l'enregistrement.
7. Dépannage des Erreurs Courantes d'Installation (rea doctor)
Lors d'un diagnostic via rea doctor --json, voici comment résoudre les quatre blocages les plus fréquents :
- Fenêtre Modale de Premier Lancement Hopper sur macOS : Au premier démarrage sur macOS, Hopper affiche une boîte de dialogue de licence/démo qui bloque les appels MCP automatisés. Ouvrez Hopper manuellement une fois dans votre session graphique pour valider ce dialogue.
- Prérequis
procpssous Linux : Les conteneurs Linux minimalistes utilisant lepsde BusyBox échouent au contrôle de propriété des processus pour Ghidra, JADX et Electron ; installez le paquetprocpscomplet (apt-get install -y procps). - Dépassement de Délai sur les Gros Binaires Natifs : Pour les binaires C++, Rust ou Unity volumineux, augmentez le délai d'initialisation via
REA_GHIDRA_STARTUP_TIMEOUT_MS=300000ouREA_HOPPER_STARTUP_TIMEOUT_MS=180000. - Configuration JDK sous Windows x64 : Vérifiez que
JAVA_HOMEpointe vers un JDK complet et validez la détection des moteurs avecrea doctor --json.
Graphes AST sur Code Source vs. Inspection Binaire REA
Lorsque vous disposez déjà du dépôt source, un graphe de connaissances AST déterministe est nettement plus rapide et économe en jetons ; REA cible spécifiquement les binaires compilés sans code source, les archives .asar tierces et l'audit d'exposition avant mise en production. Mesurez également votre visibilité dans les moteurs IA grâce à notre outil d'Audit GEO et Recherche IA.
8. Sécurité d'Entreprise et Architecture Zero-Trust : Considérez le Code Client comme Public
La démocratisation de la rétro-ingénierie assistée par agents impose une rigueur immédiate aux directions techniques.
Chaîne d'Approvisionnement, Licences et Gouvernance LLM
- Sources Officielles Exclusivement : Protégez votre poste contre les dépôts piégés en installant REA uniquement depuis
github.com/morluto/rea,rea.toolsou le paquet npm officielrea-agents. - Analyse Locale vs. Confidentialité du Modèle : REA n'envoie aucun binaire vers ses propres serveurs, mais les résultats d'outils transmis à l'agent transitent par votre fournisseur LLM ; privilégiez des accès entreprise sans rétention de données.
- Respect des Licences Commerciales : IDA Pro, Hopper et JEB exigent des licences valides ; l'usage de REA est strictement réservé à la recherche légitime, à l'interopérabilité et aux audits autorisés.

Trois Règles Défensives pour les CTO et Équipes Produit
- Zéro Source Map ni Secret dans les Livrables Clients : Intégrez un contrôle automatique en CI/CD pour bannir fichiers
.map, URL internes et clés API des bundles distribués. - Validation Zero-Trust sur Chaque Frontière IPC et API : Authentifiez et validez par schéma chaque appel
ipcMainou API côté serveur. - Isolation Backend des Algorithmes Stratégiques : Gardez tarification dynamique, détection de fraude et cloisonnement multi-locataire exclusivement sur vos serveurs sécurisés.
Sécurisez Votre Architecture Logicielle avec Kling Digital
Pour auditer la surface d'exposition de vos applications, concevoir une architecture SaaS Zero-Trust ou intégrer des flux MCP gouvernés, estimez votre cadrage via notre calculateur de coût de projet ou contactez l'équipe d'ingénierie Kling Digital.




