REA: Reverse Engineering للتطبيقات بالذكاء الاصطناعي — Claude Code وCodex وCursor

🔗 رابط المشروع على GitHub: https://github.com/morluto/rea

📦 الحزمة على npm: npmjs.com/package/rea-agents

📘 التوثيق (العربية): README_ar.md

---

الـ Reverse Engineering (الهندسة العكسية) من زمان كان محصور في فئة ضيقة جداً من المهندسين — عشان الأدوات معقّدة (IDA Pro، Hopper، Ghidra)، والـ workflow محتاج ساعات من الاستكشاف اليدوي. طلعت الـ AI agents وبدأ الناس يفكروا: ممكن الـ agent يعمل RE بدل الإنسان؟

REA (Reverse Engineer Anything) من morluto هو أول محاولة جادة تخلي الـ AI agent (Claude Code، Codex، Cursor، Gemini) يعمل reverse engineering للتطبيقات على مستوى الـ binary. الـ repo صغير (413 نجمة، MIT) لكنه بيلفت النظر كـ new category.

الفكرة في جملة

REA بيدي الـ AI agent قدرة فتح أي تطبيق (Mac، Linux، Windows PE، Electron، ASAR، Android APK، iOS IPA)، يحلّله على مستوى الـ assembly، ويشرحلك ازاي الـ feature بتشتغل. ممكن حتى يبنيلك feature مشابهة في مشروعك.

الـ prompt الواحد ده في جلسة Claude Code:

Reverse engineer the Notes app. Find how offline search works, explain it,
and build a version for my project using TypeScript and SQLite.

الـ agent بيعمل 6 خطوات تلقائياً:

• يفتح الـ binary ويتعرّف عليه
• يدور على strings وsymbols لها علاقة بـ “offline search”
• يربط الـ clues بالكود الفعلي عبر xrefs
• يرسم الـ call graph للـ routines المعنية
• يفك الـ decompilation ويقرأ الـ pseudocode
• يبني feature مشابهة في مشروعك

مكونات REA — الـ Architecture

1) 🔧 Deep Analysis Providers

• Hopper — تطبيق تجاري ممتاز للـ Mac/Linux (فيه demo mode مجاني)
• Ghidra (NSA، مفتوح المصدر) — دعم تجريبي كامل على Linux + Windows x64
• 19 operation على Ghidra adapter: inventory، decompilation، assembly، xrefs، call graphs

2) 🖥️ 7 Agent Integrations

الـ setup بيرصد ويتكامل تلقائياً مع:

• Claude Code + Claude Desktop
• Codex (OpenAI)
• Cursor
• Gemini CLI
• Windsurf
• Devin (مرصود بس بدون تكامل تلقائي)

3) 🧰 Tool Catalog — 116+ أداة

• Native Inspection (36 أداة): procedures، pseudocode، assembly، strings، xrefs، callers/callees
• Investigation Workflows (13): binary_overview، analyze_function، trace_feature، batch_decompile
• Browser Observation (9): CDP capture لمواقع Chrome
• Electron Analysis (5): تحليل تطبيقات Electron على مستوى الـ ASAR
• JavaScript Runtime (2): Node + Electron V8 Inspector observation
• Application Workflows (12): cross-layer traces، version matching
• Workspace (23): Evidence v2 bundles، lifecycle management

4) 📋 Evidence v2

كل نتيجة بتُسجّل كـ deterministic Evidence v2 record مع artifact identity، provider identity، confidence، authority، limitations، locations. ده بيخلي النتائج قابلة لإعادة الإنتاج والمراجعة.

5) 🛡️ Local by Design

كل التحليل بيحصل على جهازك المحلي. مفيش رفع للـ binary على سيرفر خارجي. الـ bridge communication عبر authenticated private local sockets.

Quickstart

npm install --global rea-agents
rea setup
rea doctor
rea analyze /Applications/Notes.app

أو بدون تثبيت:

npx --yes rea-agents@latest setup

الـ wizard بيعرض عليك خطة واضحة قبل تطبيق أي حاجة، ويطلب الموافقة. No هي الـ default — تقدر تلغي أي وقت بـ Ctrl-C.

متطلبات التشغيل

• macOS 12 أو أحدث
• Ubuntu 24.04+، Fedora 41+، أو Arch Linux 64-bit
• Windows x64 (للـ Ghidra PE P0 التجريبي فقط)
• Node.js 22.19+
• Hopper (demo مجاني) أو Ghidra (مجاني كامل)

⚖️ ملاحظة عملية

الـ reverse engineering أداة مثل أي أداة — له استخدامات مشروعة (interoperability، security research، malware analysis، compatibility work، تحليل تطبيقاتك اللي فقدت source code بتاعها، بناء patches لتطبيقات مش موثقة). الـ EULA لكل تطبيق تجاري بيحدد شروط الـ RE، فراجع شروط استخدام أي تطبيق قبل ما تحلّله.

الاستخدامات الأمنة والشائعة:

• Security research — تحليل malware أو vulnerabilities
• Interoperability — بناء client لـ API غير موثق
• Your own binaries — تحليل تطبيقاتك اللي فقدت الـ source
• Open-source analysis — فهم مشاريع مفتوحة محتاجة deep dive
• Learning — دراسة ازاي الـ compilers بتُنتج الـ assembly

REA في سياق Multi-Agent Stack

REA يضيف طبقة جديدة لـ stack الـ AI agents اللي بتبنيه:

• 🤲 Hands — Cua (computer use)
• 🎯 Skills — Claude Code Templates
• 🏢 Org — Paperclip
• 🧠 Memory — Hindsight، Claude-Mem
• 🎙️ Voice — VoiceStudio
• 🛡️ Security Sandbox — OpenShell
• 💬 Interface — OpenClaw
• 🔬 Reverse Engineering — REA (الجديد)

ده بيخلي الـ agent قادر على فهم أي سوفت وير، مش بس التفاعل معه.

مين REA مناسب له؟

• Security researchers — malware analysis بـ 10x speed
• Developers building integrations — فهم APIs غير موثقة
• Reverse engineers محترفين — automation للـ workflow الروتيني
• Students — تعلّم RE بمساعدة الـ agent
• Legacy software maintainers — فهم كود قديم بدون source

مش مناسب لمين؟

• Business owners وmarketers (مش مجالهم)
• Web developers عاديين (overkill لمعظم المهام)
• Mobile app developers (أدوات أبسط أفضل لـ debugging)

📎 رابط المشروع: github.com/morluto/rea