1. Bilgisayarınızı hazırlayın
İnceleyeceğiniz dosyaların bulunduğu bilgisayarı kullanın. Yerel olarak çalışan bir kodlama ajanı bu dosyaları okuyabilir ve sizin için araçları çalıştırabilir.
Terminali nasıl açarım?
- Windows: Başlat menüsünü açın, PowerShell yazın ve Enter tuşuna basın.
- macOS: ⌘ Space tuşuna basın, Terminal yazın ve Enter tuşuna basın.
- Linux: çoğu masaüstünde Ctrl Alt T tuşlarına basın.
Ctrl V ile bir komut yapıştırın ( macOS : ⌘ V; Linux terminalleri: Ctrl Shift V), ardından Enter tuşuna basın.
Komutları terminale yazın. “Kodlama ajanınız” etiketli istemleri ise ajanın sohbetine yapıştırın.
İhtiyacın Node.jsolacak 22 (22.19+), 24 (24.11+) veya 26+. npm ile birlikte gelirNode.js.
Node.js yok mu, emin değil misiniz?
Bir terminal açın ve kontrol edin:
node -v
npm -v
node -v, v22.19+, v24.11+ veya v26+ gösterirse hazırsınız. Daha eski bir sürüm ya da "not recognized" / "command not found" hatası gösterirse Node.js 24 LTS kurun:
Windows (PowerShell)
winget install --exact --id OpenJS.NodeJS.LTS
Koşulları kabul etmeniz istenirse Y yazın. Powershell'i kapatın, tekrar açın, ardından node -v çalıştırın.
winget yoksa Node.js yükleyicisini indirin.
Daha sonra npx çalıştırırken PowerShell "running scripts is disabled on this system" derse bunun yerine npx.cmd kullanın. npm için npm.cmd kullanın:
npx.cmd rea-agents@latest setup
macOS
İlk kurulum için Node.js 24 LTS macOS yükleyicisini (.pkg) indirin, açın ve kurulum adımlarını izleyin. Ardından Terminal’i yeniden açın.
Zaten Homebrew kullanıyor musunuz?
brew install node
Linux
curl ve unzip yoksa önce onları kurun. Debian veya Ubuntu’da sudo apt install curl unzip çalıştırın; diğer dağıtımlarda paket yöneticinizi kullanın.
curl -fsSL https://fnm.vercel.app/install | bash
Terminali kapatın, yeniden açın, ardından:
fnm install 24
fnm use 24
fnm default 24
Dağıtımınızın kendi nodejs paketi genellikle 22.19'dan eskidir, bu nedenle bunun yerine kullanıyorsanız node -v kontrol edin.
Normal bir yükleyiciyi mi tercih edersiniz? LTS sürümünü şuradan indirin: nodejs.org .
Ajanınız için bir çalışma klasörü oluşturun
Terminalde alıştırma için bir klasör oluşturun, ardından bu klasöre geçin:
mkdir rea-work
cd rea-work
Bir sonraki adım için bu terminali açık tutun. Zaten bir çalışma klasörünüz varsa onun yerine o klasörü açın.
2. Bir kodlama ajanı seçin
Ajanınız, sohbet ettiğiniz yapay zekâdır. REA ona yazılımı incelemek için araçlar sağlar. Aşağıdan bir istemci uygulaması seçin; daha önce kullanmadıysanız talimatlarını açın.
Codex · ChatGPT hesabınızı kullanın
Codex’i işletim sisteminize uygun komutla kurun:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Kurulumdan sonra terminali yeniden açın ve çalışma klasörüne dönün. Ardından Codex’i başlatın:
codex
“Sign in with ChatGPT” seçeneğini seçin, tarayıcıda giriş işlemini tamamlayın, ardından terminale dönün. Mesaj kutusu göründüğünde 3. adıma geçin.
Cursor, Windsurf veya VS Code · bir editör kullanın
- İşletim sisteminize uygun editörü kurun ve giriş yapın.
- 1. adımda oluşturduğunuz rea-work klasörünü açın.
- Editörün yapay zekâ sohbetini açın ve Agent modunu seçin. Windsurf veya Devin Desktop’ta ajan sohbetini açın; VS Code’da önce GitHub Copilot’ı ayarlayın.
Cursor kurulumu · Windsurf / Devin Desktop kurulumu · VS Code ve Copilot kurulumu
Claude Code · Claude hesabınızı kullanın
İşletim sisteminize uygun komutla kurun:
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
Terminali yeniden açın, çalışma klasörünüze dönün ve claude çalıştırın. Giriş talimatlarını izleyin. Kullanım için uygun bir Claude aboneliği veya yapılandırılmış bir API hesabı gerekir.
Claude Desktop · masaüstü sohbetini kullanın
Windows veya macOS’a Claude Desktop’ı kurun ve giriş yapın. Uygulamadan tamamen çıkın, ardından Claude dışında açtığınız bir terminalde şu komutu çalıştırın:
npx rea-agents@latest setup --client claude_desktop
Planı inceleyip onaylayın, Claude’u yeniden açın, ardından 3. adımdaki bağlantı kontrolünü yapın.
Claude Desktop’ı indirin · Claude Desktop bağlantı ayrıntıları
OpenCode · bir yapay zekâ modeli seçin
npm install --global opencode-ai
Çalışma klasörünüzde opencode çalıştırın. Model hesabınızı bağlamak için sohbetinde /connect kullanın, ardından bir model seçin.
Desteklenen tüm istemciler ve kurulum kimlikleri
npm’deki 6.4.0 sürümü aşağıdaki istemcileri destekler. Belirli bir istemciyi seçmek için kimliğini --client ile kullanın.
| İstemci | Kurulum kimliği |
|---|---|
| Claude Code | claude_code |
| Claude Desktop | claude_desktop |
| Codex | codex |
| Cursor | cursor |
| Gemini CLI | gemini_cli |
| Windsurf | windsurf |
| Devin | devin |
| OpenCode | opencode |
| Antigravity | antigravity |
| GitHub Copilot CLI | copilot_cli |
| Command Code | commandcode |
| Qwen Code | qwen_code |
| VS Code | vscode |
| Grok Build | grok_build |
| OMP | omp |
| Pi | pi |
| Hermes | hermes |
Qoder (qoder), Factory Droid (droid), Trae (trae), ZCode (zcode) ve DeepSeek Harness (dsh) deponun main dalında mevcuttur; kaynak koddan derlenmiş bir sürüm veya bu entegrasyonları içeren bir yayımlanmış sürüm kullanın.
İstemci yapılandırması ve sorun giderme · Yayımlanmış sürümlerde kullanılabilirlik
Grok Bot · barındırıldığı bilgisayarda bağlayın
Grok Bot’un sohbetinde, Bot’un bilgisayarında şu komutu kullanarak rea adlı özel bir MCP sunucusu eklemesini isteyin:
npx -y rea-agents@6.4.0 mcp
3. REA’yı bağlayın
Bu istemi kodlama ajanınıza yapıştırın:
npx rea-agents@latest setup kullanarak REA’yı kur ve bu kodlama ajanına bağla. Önce kurulum planını göster ve onayımı bekle. Ardından kurulumu doğrula.
Veya kurulumu kendiniz çalıştırın
npx rea-agents@latest setup
Belirli bir istemci için kurulum kimliğini ekleyin:
npx rea-agents@latest setup --client codex
npm paketi indirmek için onay isterse y yazıp Enter’a basın. REA’nın istemci listesinde ok tuşlarıyla ilerleyin, Space ile istemcinizi seçin ve Enter ile devam edin.
İstemcinizi seçin ve kurulum planını gözden geçirin. REA, MCP bağlantısını ve eşleşen araştırma becerisini ekleyerek mevcut yapılandırmanın yedeğini alır. Değişiklikleri uygulamadan önce sorar.
MCP, ajanınızın REA araçlarını çağırmasını sağlayan bağlantıdır. Beceri ise yazılım incelemesi için bir iş akışı sunar.
İlk alıştırma için isteğe bağlı Hopper kurulumunu atlayabilirsiniz. Kurulum tamamlanınca istemcinizi yeniden başlatın.
İstemcimi nasıl yeniden başlatırım?
Masaüstü uygulamaları (Claude Masaüstü, Cursor, Windsurf, VS Code): uygulamadan tamamen çıkın, ardından tekrar açın. Pencereyi kapatmak yeterli değil. macOS'DA ⌘ Q tuşuna basın; Windows'DA varsa tepsi simgesinden de çıkın.
Terminal aracıları (Claude Code, Codex , Gemini CLI ): oturumdan çıkın ve yeniden başlatın.
npx -y rea-agents@latest doctor --client codex --json
codex yerine istemcinizin kurulum kimliğini yazın. Başarılı bir kontrol "healthy": true sonucunu verir. Ardından ajanınıza şunu sorun:
REA’nın bağlı olduğunu kontrol et ve hangi REA araçlarını kullanabildiğini göster.
4. İlk incelemenizi deneyin
Örnek, Notları Dışa Aktar düğmesine sahip altı dosyadan oluşan bir Electron uygulamasıdır. Aracınız, Electron'YU yüklemeden veya başlatmadan kodunu inceleyebilir.
https://rea.tools/examples/notes-example.zip adresindeki arşivi yeni bir örnek klasöre indir ve aç. Export notes düğmesine tıkladığımda ne olduğunu REA ile bul. notes.csv dosyasının nereye yazıldığını, hangi alanları içerdiğini ve ilgili dosyaları ve satırları göster.
Dosya ve satır referanslarıyla kısa bir açıklama arayın:
Düğme bir
notes:exportmesajı gönderir. Ana süreç notları CSV olarak biçimlendirir venotes.csvdosyasını kullanıcının İndirilenler klasörüne yazar. Sütunlaridvetitle.
Rehberli alıştırmada bir tahmini kontrol edin →
Örneği kendiniz indirin veya kendi uygulamanızı kullanın
Temsilciniz dosya indiremiyorsa, bu arşivi kendiniz açın. notes-example klasörünün yolunu ve aynı dışa aktarma sorusunu verin.
/absolute/path/to/appkonumundaki uygulamayı REA ile incele. Verileri nasıl dışa aktardığını bul ve ilgili dosyaları ve satırları göster.
Bir klasörün tam yolunu nasıl alabilirim?
- Windows: Dosya Gezgini'nde klasöre sağ tıklayın ve Yol olarak kopyala'yı seçin. Windows 10'da sağ tıklarken Shift tuşunu basılı tutun.
- macOS: Finder'da klasöre sağ tıklayın, Seçeneği basılı tutun ve Yol Adı olarak "..." Kopyala'yı seçin.
- Herhangi bir sistem: klasörü bir terminal penceresine sürükleyin ve yolu görünür.
Bir terminalde, boşluk içeren bir yolun etrafına tırnak işaretleri koyun.
Başka bir yazılım türünü analiz edin
İnceleyeceğiniz hedefe uygun bölümü seçin. Analiz sağlayıcısı, REA’nın bu yazılım türü için kullandığı yerel analiz aracıdır.
Yerel makine kodlu çalıştırılabilir dosyalar ve kütüphaneler · Hopper, Ghidra veya IDA
REA’nın çalıştığı bilgisayara bir analiz aracı kurun. Ana sistem, işletim sisteminizdir; hedef ise incelemek istediğiniz programdır.
| Analiz sağlayıcısı | Windows | macOS | Linux |
|---|---|---|---|
| Hopper | Kullanılamıyor | 12+ | Desteklenen dağıtımlar |
| Ghidra | x64 · deneysel | x64 / arm64 | x64 / arm64 |
| IDA | Doğrulanmış profiller | Doğrulanmış grafik arayüzsüz profil | Sağlayıcı kılavuzuna bakın |
Hopper · kurulumun yüklemesine veya bağlamasına izin verin
Hopper'YU macOS veya Linux'YA bağlayın. Yukarıdaki kurulum komutunu çalıştırın; Mevcut bir kurulumu algılar veya onayınız için bir kurulum planı sunar.
Kurulumda Hopper’ı seçin ve ayrı kurulum planını inceleyin. macOS’ta Hopper ilk açıldığında demo modunu seçin veya lisansınızı etkinleştirin. Linux’ta kurulum, desteklenen demoyu ve ona özel ekran ortamını hazırlar.
Linux sistemleri: Ubuntu 24.04+, Fedora 41+, Nobara 44+, Arch Linux, CachyOS veya Omarchy. Hopper ticari bir yazılımdır; demosunun sınırlarını üretici belirler.
npx -y rea-agents@latest doctor --provider hopper --json
macOS Otomasyon izni isterse Sistem Ayarları → Gizlilik ve Güvenlik → Otomasyon bölümünde REA’yı başlatan uygulamaya izin verin, ardından yeniden deneyin.
Ghidra · ücretsiz analiz aracını ve Java’yı kurun
- Java derleyicisini de içeren 64 bit JDK 21 veya daha yeni bir sürüm kurun. Bilgisayarınızın mimarisine uygun paketi seçin.
-
Ghidra 12.1.4’ü sürümün Assets listesinden indirin ve
ghidra_…_PUBLIC_….ziparşivini açın. “Source code” yerine sürüm arşivini seçin. -
Açılan dosyalar arasında
ghidraRunveyaghidraRun.batiçeren klasörü bulun.GHIDRA_INSTALL_DIRiçin bu klasörü kullanın.
JDK indirin · Ghidra 12.1.4’ü indirin
Java’yı kontrol edin. İlk komut java.home değerini gösterir; JAVA_HOME için bu klasörü kullanın. İkinci komut derleyicinin kurulu olduğunu doğrular:
java -XshowSettings:properties -version
javac -version
Ghidra'YU Windows'ya bağlayın
Windows x64, yerel x86 ve x64 PE uygulamaları ve sabit yerel NTFS sürücülerindeki dll'ler için deneysel, salt okunur desteğe sahiptir. Mevcut bir Ghidra 12.1 kullanın.x kurulum ve 64 bit JDK 21 veya daha yenisi:
$env:GHIDRA_INSTALL_DIR = "C:/tools/ghidra_12.1.4_PUBLIC"
$env:JAVA_HOME = "C:/tools/jdk-21"
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup
İki yolu kurulumlarınızla değiştirin, ardından kurulum planını gözden geçirin.
Ghidra kurulumunuzu bağlayın
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"
Her iki yolu da mevcut kurulumlarınızın yollarıyla değiştirin. Yeni bir macOS veya Linux arm64 kurulumunda, devam etmeden önce bilgisayarınız için yerel decompiler’ı derleyin.
Ghidra’nın yerel decompiler’ını derleyin
macOS’ta derleme için Xcode Command Line Tools, make ve bison gerekir. Bilgisayarınıza uygun kılavuzu kullanın:
Ardından Ghidra’yı kontrol edin ve yollarını istemciniz için kaydedin:
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup
Bu komutları aynı terminal oturumunda çalıştırın. Yolları ayarladıktan sonra kurulumu yeniden çalıştırın, güncellenen istemci yapılandırmasını onaylayın ve ajanınızı yeniden başlatın.
Ghidra kurulumu ve mimari gereksinimleri · Windows Ghidra kılavuzu
IDA · mevcut bir kurulumu bağlayın
IDA sağlayıcı kılavuzunu kullanarak IDA tarafındaki MCP sunucusunun bağlantı kaydını hazırlayın. Özgün ikili dosyanın açık olduğu bir grafik arayüze bağlanmayı veya özel bir veritabanı açan grafik arayüzsüz denetleyiciyi seçin.
Doğrulanmış profiller arasında Windows’taki eski grafik arayüz bağlantısı ve grafik arayüzsüz denetleyici ile IDA Professional 9.1 kullanan macOS arm64 grafik arayüzsüz denetleyici bulunur. İsteğe bağlı yerel GUI köprüsünün ayrıca sürüm ve platform gereksinimleri vardır.
macOS başsız profili ve yerel GUI köprüsü için REA kaynak derlemesi veya bu değişiklikleri içeren bir sürüm gerekir. npm 6.4.0 bunları içermez.
Derlenmiş kaynak dizininden, aşağıdaki npx komutları yerine node scripts/rea.mjs doctor --provider ida --json ve node scripts/rea.mjs setup çalıştırın.
IDA bağlantı kayıt dosyasını hazırlayın
Aşağıdaki IDA kılavuzuyla IDA tarafındaki sunucuyu kurup yapılandırın. Ardından çalışan bağlantı kaydını bir metin editöründe ida-mcp.json olarak kaydedin. Windows’ta Not Defteri’nde kaydederken “Tüm dosyalar”ı seçin; böylece dosya adına .txt eklenmez.
idb_open, idb_list ve idb_close araçlarını sunan grafik arayüzsüz bir denetleyici için dosya şöyle olabilir:
{
"command": "idalib-mcp",
"args": ["--stdio", "--max-workers", "1"],
"mode": "headless"
}
Bağlı bir eski 1.4.0 GUI sunucusu için çalışan command, args ve varsa env değerlerini dosyaya kopyalayın. REA’dan inceleme istemeden önce özgün ikili dosyayı IDA’da açın ve IDA tarafındaki eklentiyi başlatın.
$env:REA_IDA_MCP_CONFIG = "C:/analysis/ida-mcp.json"
$env:REA_ANALYSIS_PROVIDER = "ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup
export REA_IDA_MCP_CONFIG="/absolute/path/to/ida-mcp.json"
export REA_ANALYSIS_PROVIDER="ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup
Sağlayıcı kılavuzuyla hazırladığınız JSON bağlantı kayıt dosyasını kullanın, ardından kurulumu yeniden çalıştırın ve ajanınızı yeniden başlatın.
IDA profilleri, bağlantı kaydı örnekleri ve doğrulanmış platformlar
Bağlantı kurulduğunda ajanınıza özgün çalıştırılabilir dosyanın tam yolunu verin ve analiz sağlayıcınızı belirtin:
REA ve yapılandırdığım sağlayıcıyla
/absolute/path/to/programdosyasını incele. İşlevlerini ve dizelerini listele, ardından kullanıcı girdisini işleyen bölümü kod referanslarıyla açıkla.
Web siteleri, Android, .NET, donanım yazılımları ve diğer hedefler
Elinizdeki hedefin kılavuzunu açın. Her kılavuz ek araçları, desteklenen sistemleri ve ilk komutu gösterir.
| Hedef | Hazırlanacak araçlar | Kılavuz |
|---|---|---|
| JavaScript / Electron | Node.js + npm | Kılavuzu açın |
| Web sitesi | Chrome / Chromium / Edge | Kılavuzu açın |
| .NET / Flutter / paketler | Node.js + npm | Kılavuzu açın |
| Android APK | JADX + JDK 17+ | Kılavuzu açın |
| Android cihazı | adb | Kılavuzu açın |
| Android kaynakları | Apktool + Java | Kılavuzu açın |
| JEB projesi | JEB + MCP | Kılavuzu açın |
| Donanım yazılımı | Binwalk / Unblob · Linux | Kılavuzu açın |
| WASM | WABT | Kılavuzu açın |
| SQLite veritabanı | Node.js 24.15+ / 26+ | Kılavuzu açın |
| EVM bayt kodu | Node.js · Linux x64 | Kılavuzu açın |
| ELF / Linux çökmesi | pwntools / GDB / pwndbg | Kılavuzu açın |
| HAR / SAZ / mitmproxy | Node.js / mitmdump | Kılavuzu açın |
| PCAP / PCAPNG | TShark / capinfos · Linux | Kılavuzu açın |
| Mantık sinyalleri | sigrok-cli · Linux | Kılavuzu açın |
| Süreç davranışı | PTY · Linux / macOS | Kılavuzu açın |
Flutter kılavuzu · Paketler ve kaynaklar · EVM bayt kodu · Tüm inceleme kılavuzları
REA’yı terminalden kullanın
CLI komutları, genel kurulum ve curl
Uygulamayı çalıştırmadan bir JavaScript veya Electron uygulama klasörünü veya ASAR arşivini analiz edin:
npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json
Yolu çıkarılan uygulama dizininizle değiştirin veya .asar dosyası. Windows'DA "D:/apps/example" burada çalışıyor.
Bir uygulamayı nerede bulabilirim.asar dosyası mı?
Electron uygulamaları genellikle bir resources klasöründe saklar:
-
Windows:
C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar -
macOS :
/Applications/<App>.app/Contents/Resources/app.asar(uygulamaya sağ tıklayın ve Paket içeriğini Göster'i seçin) -
Linux: genellikle
/opt/<App>/resources/app.asar
Bazı uygulamalar başka bir yere yüklenir. Uygulama için app.asar.
Sonuç, uygulamayı tanımlar, modüller arasındaki bağlantıları gösterir ve kaynak konumlarını verir. REA'NUN çözemediği bağlantılar sonuçta işaretlenir.
Kabuğunuzda kalıcı bir rea komutu istiyorsanız:
npm install --global rea-agents
JavaScript uygulama kılavuzu ile devam edin
npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json
main yerine hedefin fonksiyon listesinden bir fonksiyon adı veya adresi yazın. Önce Ghidra’nın yapılandırılması gerekir.
macOS veya Linux’ta Node.js’i hazırladıktan sonra curl yükleyicisini de kullanabilirsiniz:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
Ajanını bağlamak için kurulum istemlerini izle. Görünmezlerse rea setup çalıştır.
Kabuk rea komutunu bulamıyorsa yükleyicinin yazdırdığı yürütülebilir dosya yolunu kullanın. Linux'ta varsayılan kurulum komutu "$HOME/.local/bin/rea" setup şeklindedir.
Yardım almak
Temsilciniz REA'YU görmüyorsa
Kur'dan sonra istemciyi yeniden başlatın veya yeniden bağlayın. REA bağlantısını doctor kontrol edin; Codex için :
3. adımdaki istemci kontrolünü kendi kurulum kimliğinizle kullanın. Editör istemcilerinde MCP ayarlarında REA’yı etkinleştirin ve ajan sohbetinde araçlarına izin verin.
Bir sağlayıcının dikkat etmesi gerekiyorsa
Kullandığınız sağlayıcıyı kontrol edin. Ghidra için :
npx -y rea-agents@latest doctor --provider ghidra --json
Rapor, başarısız kontrolü ve önerilen bir sonraki adımı verir.
Windows, WSL ve boşluk içeren yollar
Windows istemcileri ve analiz araçları için Windows PowerShell kullanın. Ajanınız WSL içinde çalışıyorsa Node.js ve REA’yı o Linux ortamında kurun ve orada Linux yollarını kullanın. Grafik arayüzsüz sağlayıcılar REA ile aynı sistemde çalışır.
Bir terminalde, boşluk içeren bir yolun etrafına tırnak işaretleri koyun.
Windows kurulum komutu:
npx.cmd rea-agents@latest setup
REA’yı güncelleyin veya kaldırın
Ajan bağlantınızı yenilemek için en güncel kurulum komutunu tekrar çalıştırın, planını inceleyin ve istemcinizi yeniden başlatın.
npx rea-agents@latest setup
Genel CLI kurulumu yaptıysanız rea update ile güncelleyin. REA’nın istemci yapılandırmasını ve becerisini kaldırmak için npx rea-agents@latest uninstall kullanın.
- REA SSS Güncellemeler, aracılar ve analizler hakkında hızlı cevaplar.
- Bir ikili, bir Electron uygulaması ve bir tarayıcı için çalışılan bir araştırma kılavuzu seçin.
- GitHub sorunları Komut ve tanılama ile ilgili bir sorun bildirin.
- REA topluluk Soruları, soruşturmaları ve devam eden çalışmalar.
