Siapkan REA .

Siapkan komputer dan agen pemrogramanmu, hubungkan REA, lalu selidiki aplikasi kecil.

Baru pertama kali? Ikuti empat langkah di bawah. Sudah punya agen? Langsung ke Hubungkan REA.

1. Siapkan komputermu

Gunakan komputer tempat berkas target disimpan. Agen pemrograman lokal bisa membaca berkas itu dan menjalankan alat untukmu.

Bagaimana cara membuka terminal?
  • Windows : buka menu Mulai, ketik PowerShell dan tekan Enter.
  • macOS: tekan ⌘ Space, ketik Terminal, lalu tekan Enter.
  • Linux: tekan Ctrl Alt T di sebagian besar lingkungan desktop.

Tempel perintah dengan Ctrl V (macOS : ⌘ V; Terminal Linux: Ctrl Shift V), lalu tekan Enter.

Masukkan perintah di terminal. Prompt berlabel “Agen pemrogramanmu” dimasukkan ke percakapan agen.

Anda akan membutuhkan Node.js 22 (22.19+), 24 (24.11+) atau 26+. npm hadir dengan Node.js.

Tidak memiliki Node.js, atau tidak yakin?

Buka terminal dan periksa:

Terminal
node -v
npm -v

Jika node -v menampilkan v22.19+, v24.11+, atau v26+, kamu sudah siap. Jika menampilkan versi lebih lama atau "not recognized" / "command not found", instal Node.js 24 LTS:

Windows (PowerShell)
Windows PowerShell
winget install --exact --id OpenJS.NodeJS.LTS

Ketik Y jika diminta untuk menerima persyaratan. Tutup PowerShell, buka lagi, lalu jalankan node -v.

Unduh penginstal Node.js jika winget tidak tersedia.

Jika nanti PowerShell menampilkan "running scripts is disabled on this system" saat kamu menjalankan npx, gunakan npx.cmd sebagai gantinya. Untuk npm, gunakan npm.cmd:

Windows PowerShell
npx.cmd rea-agents@latest setup
macOS

Untuk instalasi pertama, unduh penginstal Node.js 24 LTS untuk macOS (.pkg), buka dan ikuti petunjuknya. Lalu buka kembali Terminal.

Sudah menggunakan Homebrew?
macOS · Homebrew
brew install node
Linux

Instal curl dan unzip terlebih dahulu jika belum ada. Di Debian atau Ubuntu, jalankan sudo apt install curl unzip; di distribusi lain, gunakan pengelola paketmu.

Linux
curl -fsSL https://fnm.vercel.app/install | bash

Tutup terminal, buka kembali, lalu:

Linux
fnm install 24
fnm use 24
fnm default 24

Distribusi Anda sendiri nodejs paket seringkali lebih lama dari 22.19, jadi periksa node -v jika Anda menggunakannya sebagai gantinya.

Lebih suka penginstal biasa? Unduh versi LTS dari nodejs.org.

Buat folder kerja untuk agenmu

Di terminal, buat folder untuk latihan ini lalu masuk ke dalamnya:

Terminal
mkdir rea-work
cd rea-work

Biarkan terminal ini terbuka untuk langkah berikutnya. Jika sudah punya folder kerja, buka folder itu saja.

2. Pilih agen pemrograman

Agenmu adalah AI yang kamu ajak bicara. REA menyediakan alat pemeriksaan yang digunakannya. Pilih satu aplikasi di bawah; buka petunjuknya jika belum pernah menggunakannya.

Codex · gunakan akun ChatGPT-mu

Instal Codex dengan perintah untuk sistem operasimu:

Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Setelah instalasi, buka kembali terminal dan masuk ke folder kerja. Lalu mulai Codex:

Terminal
codex

Pilih “Sign in with ChatGPT”, selesaikan proses masuk di browser, lalu kembali ke terminal. Saat kotak pesan muncul, lanjutkan ke langkah 3.

Instalasi Codex dan masuk akun

Cursor, Windsurf, atau VS Code · gunakan editor
  1. Instal editor untuk sistem operasimu dan masuk ke akun.
  2. Buka folder rea-work yang kamu buat pada langkah 1.
  3. Buka percakapan AI dan pilih mode Agent. Di Windsurf atau Devin Desktop, buka percakapan agen; di VS Code, siapkan GitHub Copilot terlebih dahulu.

Penyiapan Cursor · Penyiapan Windsurf / Devin Desktop · Penyiapan VS Code dan Copilot

Claude Code · gunakan akun Claude-mu

Instal dengan perintah untuk sistem operasimu:

Windows PowerShell
irm https://claude.ai/install.ps1 | iex
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

Buka kembali terminal, masuk ke folder kerja, lalu jalankan claude. Ikuti petunjuk masuk akun. Akses memerlukan langganan Claude yang memenuhi syarat atau akun API yang sudah dikonfigurasi.

Instalasi Claude Code dan pilihan akun

Claude Desktop · gunakan aplikasi percakapan desktop

Instal Claude Desktop di Windows atau macOS dan masuk ke akun. Tutup sepenuhnya, lalu jalankan perintah ini dalam terminal yang dibuka di luar Claude:

Terminal
npx rea-agents@latest setup --client claude_desktop

Tinjau dan setujui rencana, buka kembali Claude, lalu periksa koneksi pada langkah 3.

Unduh Claude Desktop · Detail koneksi Claude Desktop

OpenCode · pilih model AI
Terminal
npm install --global opencode-ai

Jalankan opencode di folder kerja. Gunakan /connect dalam percakapannya untuk menghubungkan akun modelmu, lalu pilih model.

Instalasi OpenCode dan penyiapan model

Semua aplikasi yang didukung dan ID penyiapannya

Rilis npm 6.4.0 mendukung aplikasi di bawah. Gunakan ID bersama --client saat memilih aplikasi secara eksplisit.

Aplikasi ID penyiapan
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), dan DeepSeek Harness (dsh) tersedia di cabang main repositori; gunakan build dari sumber atau rilis yang menyertakan integrasi tersebut.

Konfigurasi aplikasi dan pemecahan masalah · Ketersediaan dalam rilis

Grok Bot · hubungkan di komputer tempat Bot dihosting

Dalam percakapan Grok Bot, minta Bot menambahkan server MCP khusus bernama rea menggunakan perintah ini di komputernya:

Grok Bot
npx -y rea-agents@6.4.0 mcp

Petunjuk konektor Grok Bot

3. Hubungkan REA

Tempel prompt ini ke agen pemrograman Anda:

Agen pemrogramanmu

Pasang REA dan hubungkan ke agen pemrograman ini menggunakan npx rea-agents@latest setup. Tampilkan rencana perubahan dan tunggu persetujuan saya sebelum menjalankannya. Setelah itu, verifikasi pemasangan.

Atau jalankan pengaturan sendiri
Terminal
npx rea-agents@latest setup

Untuk satu aplikasi tertentu, tambahkan ID penyiapannya:

Terminal
npx rea-agents@latest setup --client codex

Jika npm meminta izin mengunduh paket, ketik y lalu tekan Enter. Dalam daftar aplikasi REA, gunakan tombol panah untuk berpindah, Space untuk memilih aplikasi, dan Enter untuk melanjutkan.

Pilih klien Anda dan tinjau rencana penyiapan. REA menambahkan koneksi MCP dan keterampilan investigasi pencocokan, menyimpan cadangan konfigurasi yang ada. Itu bertanya sebelum menerapkan perubahan.

MCP adalah koneksi yang memungkinkan agen memanggil REA. Skill memberinya alur kerja untuk menyelidiki perangkat lunak.

Untuk latihan pertama, kamu bisa melewati instalasi Hopper yang opsional. Mulai ulang aplikasi agen setelah penyiapan selesai.

Bagaimana cara memulai ulang klien saya?

Aplikasi desktop (Claude Desktop, Cursor, Windsurf, VS Code): tutup aplikasi sepenuhnya lalu buka kembali. Menutup jendela saja tidak cukup. Di macOS tekan ⌘ Q; di Windows, keluar juga melalui ikon tray jika ada.

Agen terminal ( Claude Code, Codex, Gemini CLI): keluar dari sesi dan mulai lagi.

Terminal
npx -y rea-agents@latest doctor --client codex --json

Ganti codex dengan ID penyiapan aplikasimu. Pemeriksaan yang berhasil melaporkan "healthy": true. Lalu minta agenmu:

Periksa bahwa REA sudah terhubung dan tunjukkan alat REA yang bisa kamu gunakan.

4. Coba penyelidikan pertamamu

Contohnya adalah aplikasi Electron enam file dengan Ekspor catatan tombol. Agen Anda dapat memeriksa kodenya tanpa menginstal atau meluncurkan Electron .

Agen pemrogramanmu

Unduh https://rea.tools/examples/notes-example.zip ke dalam folder contoh baru dan buka kemasannya. Gunakan REA untuk menemukan apa yang terjadi ketika saya mengklik Ekspor catatan. Tunjukkan dimana notes.csv ditulis, bidang mana yang dikandungnya, dan file serta baris yang relevan.

Cari penjelasan singkat dengan referensi file dan baris:

Tombol tersebut mengirimkan notes:export pesan. Proses utama memformat catatan sebagai CSV dan menulis notes.csv di folder Unduhan pengguna. Kolomnya adalah id dan title.

Uji sebuah prediksi dalam latihan terpandu →

Unduh sendiri contoh ini atau gunakan aplikasimu

Unduh contoh ZIP

Jika agen Anda tidak dapat mengunduh file, buka zip arsip ini sendiri. Berikan jalan ke notes-example folder dan pertanyaan ekspor yang sama.

Gunakan REA untuk memeriksa aplikasi di /absolute/path/to/app. Cari tahu bagaimana aplikasi mengekspor data dan tunjukkan berkas serta baris yang terkait.

Bagaimana cara mendapatkan jalur lengkap folder?
  • Windows : di File Explorer, klik kanan folder tersebut dan pilih Salin sebagai jalur. Pada Windows 10, tahan Shift sambil mengklik kanan.
  • macOS: di Finder, klik kanan folder, tahan tombol Option, lalu pilih Copy "…" as Pathname.
  • Sistem apa pun: seret folder ke jendela terminal dan jalurnya muncul.

Di terminal, beri tanda kutip di sekitar jalur yang berisi spasi.

Analisis jenis perangkat lunak lain

Pilih bagian untuk targetmu. Penyedia analisis adalah alat lokal yang digunakan REA untuk jenis perangkat lunak tersebut.

Program dan pustaka native · Hopper, Ghidra, atau IDA

Instal satu alat analisis di komputer yang menjalankan REA. Host adalah sistem operasimu; target adalah program yang ingin kamu periksa.

Penyedia analisis Windows macOS Linux
Hopper Tidak tersedia 12+ Distribusi yang didukung
Ghidra x64 · eksperimental x64 / arm64 x64 / arm64
IDA Profil yang sudah diverifikasi Profil tanpa antarmuka grafis yang sudah diverifikasi Lihat panduan penyedia analisis
Hopper · biarkan penyiapan menginstal atau menghubungkannya

Hubungkan Hopper ke macOS atau Linux . Jalankan perintah pengaturan di atas; itu mendeteksi instalasi yang ada atau menawarkan rencana instalasi untuk persetujuan Anda.

Pilih Hopper saat penyiapan dan tinjau rencana instalasinya yang terpisah. Di macOS, pilih mode demo atau aktifkan lisensi saat Hopper pertama kali dibuka. Di Linux, penyiapan menyiapkan demo yang didukung beserta tampilan privatnya.

Host Linux: Ubuntu 24.04+, Fedora 41+, Nobara 44+, Arch Linux, CachyOS, atau Omarchy. Hopper adalah perangkat lunak komersial; demonya memiliki batas yang ditentukan vendor.

Terminal
npx -y rea-agents@latest doctor --provider hopper --json

Jika macOS meminta izin Automation, izinkan aplikasi yang menjalankan REA di System Settings → Privacy & Security → Automation, lalu coba lagi.

Penyiapan Hopper dan pemecahan masalah

Ghidra · instal alat analisis gratis dan Java
  1. Instal JDK 64-bit versi 21 atau lebih baru, termasuk kompiler Java. Pilih paket yang sesuai dengan arsitektur komputermu.
  2. Unduh Ghidra 12.1.4 dari daftar Assets pada rilis dan ekstrak arsip ghidra_…_PUBLIC_….zip. Pilih arsip rilis, bukan “Source code”.
  3. Cari folder hasil ekstraksi yang berisi ghidraRun atau ghidraRun.bat. Gunakan folder itu untuk GHIDRA_INSTALL_DIR.

Unduh JDK · Unduh Ghidra 12.1.4

Periksa Java. Perintah pertama menampilkan java.home; gunakan folder itu untuk JAVA_HOME. Perintah kedua memastikan kompiler sudah terinstal:

Terminal
java -XshowSettings:properties -version
javac -version
Hubungkan Ghidra di Windows

Windows x64 memiliki dukungan eksperimental hanya-baca untuk aplikasi dan DLL native x86 dan x64 berformat PE pada drive NTFS lokal tetap. Gunakan instalasi Ghidra 12.1.x yang sudah ada dan JDK 64-bit versi 21 atau lebih baru:

Windows PowerShell
$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

Ganti kedua jalur dengan penginstalan Anda, lalu tinjau paket penyiapan.

Hubungkan instalasi Ghidra Anda
macOS / Linux
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"

Ganti kedua jalur dengan instalasi yang sudah kamu miliki. Untuk instalasi baru di macOS atau Linux arm64, build dekompiler native untuk komputermu sebelum melanjutkan.

Build dekompiler native Ghidra

Di macOS, proses build memerlukan Xcode Command Line Tools, make, dan bison. Gunakan panduan untuk komputermu:

Lalu periksa Ghidra dan simpan jalurnya untuk aplikasimu:

macOS / Linux
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

Jalankan perintah-perintah ini dalam sesi terminal yang sama. Jalankan kembali penyiapan setelah mengatur jalur, setujui konfigurasi aplikasi yang diperbarui, lalu mulai ulang agenmu.

Penyiapan Ghidra dan kebutuhan arsitektur · Panduan Ghidra untuk Windows

IDA · hubungkan instalasi yang sudah ada

Gunakan panduan penyedia IDA untuk menyiapkan registrasi MCP server upstream. Pilih GUI terhubung dengan berkas biner asli terbuka, atau supervisor tanpa antarmuka grafis yang membuka basis data privat.

Profil yang sudah diverifikasi mencakup GUI legacy dan supervisor tanpa antarmuka grafis di Windows, serta supervisor tanpa antarmuka grafis di macOS arm64 dengan IDA Professional 9.1. Bridge GUI native yang opsional memiliki kebutuhan versi dan platform sendiri.

Profil tanpa antarmuka macOS dan penghubung GUI native memerlukan REA yang dibangun dari kode sumber atau rilis yang memuat perubahan ini. npm 6.4.0 belum memuatnya.

Dari direktori kode sumber yang sudah dibangun, jalankan node scripts/rea.mjs doctor --provider ida --json dan node scripts/rea.mjs setup alih-alih perintah npx di bawah.

Siapkan berkas registrasi IDA

Instal dan konfigurasikan server upstream menggunakan panduan IDA di bawah. Lalu simpan registrasinya yang sudah berfungsi sebagai ida-mcp.json dalam editor teks. Di Windows, pilih “All files” saat menyimpan di Notepad agar tidak menambahkan .txt.

Untuk supervisor tanpa antarmuka grafis yang menyediakan idb_open, idb_list, dan idb_close, berkasnya bisa seperti ini:

ida-mcp.json
{
  "command": "idalib-mcp",
  "args": ["--stdio", "--max-workers", "1"],
  "mode": "headless"
}

Untuk server GUI legacy 1.4.0 yang terhubung, salin command, args, dan env opsional dari registrasinya yang sudah berfungsi ke berkas. Buka berkas biner asli di IDA dan mulai plugin upstream-nya sebelum meminta REA memeriksanya.

Windows PowerShell
$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
macOS / Linux
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

Gunakan berkas registrasi JSON yang kamu siapkan dengan panduan penyedia, lalu jalankan kembali penyiapan dan mulai ulang agenmu.

Profil IDA, contoh registrasi, dan platform yang sudah diverifikasi

Setelah terhubung, berikan jalur lengkap berkas program asli kepada agen dan sebutkan penyedia analisismu:

Gunakan REA dengan alat analisis yang sudah saya konfigurasikan untuk memeriksa /absolute/path/to/program. Daftarkan fungsi dan string-nya, lalu jelaskan bagian yang menangani input pengguna dengan referensi ke kode.

Ikuti contoh analisis native

Situs web, Android, .NET, firmware, dan target lain

Buka panduan untuk targetmu. Setiap panduan menjelaskan alat tambahan, host yang didukung, dan perintah pertama.

Target Alat yang perlu disiapkan Panduan
JavaScript / Electron Node.js + npm Buka panduan
Situs web Chrome / Chromium / Edge Buka panduan
.NET / Flutter / paket Node.js + npm Buka panduan
APK Android JADX + JDK 17+ Buka panduan
Perangkat Android adb Buka panduan
Sumber daya Android Apktool + Java Buka panduan
Proyek JEB JEB + MCP Buka panduan
Firmware Binwalk / Unblob · Linux Buka panduan
WASM WABT Buka panduan
Basis data SQLite Node.js 24.15+ / 26+ Buka panduan
Bytecode EVM Node.js · Linux x64 Buka panduan
ELF / crash Linux pwntools / GDB / pwndbg Buka panduan
HAR / SAZ / mitmproxy Node.js / mitmdump Buka panduan
PCAP / PCAPNG TShark / capinfos · Linux Buka panduan
Sinyal logika sigrok-cli · Linux Buka panduan
Perilaku proses PTY · Linux / macOS Buka panduan

Panduan Flutter · Paket dan sumber daya · Bytecode EVM · Semua panduan penyelidikan

Gunakan REA dari terminal

Perintah CLI, instalasi global, dan curl

Analisis folder aplikasi JavaScript atau Electron atau arsip ASAR tanpa menjalankan aplikasi:

Analisis aplikasi statis
npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json

Ganti jalur dengan direktori aplikasi yang Anda ekstrak atau .asar berkas. Pada Windows, jalur seperti "D:/apps/example" bekerja di sini.

Di mana berkas .asar suatu aplikasi?

Aplikasi Electron biasanya menyimpannya dalam resources folder:

  • Windows : C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar
  • macOS : /Applications/<App>.app/Contents/Resources/app.asar (klik kanan aplikasi dan pilih Tampilkan Isi Paket)
  • Linux : sering /opt/<App>/resources/app.asar

Beberapa aplikasi dipasang di tempat lain. Cari folder aplikasi untuk app.asar.

Hasilnya mengidentifikasi aplikasi, menunjukkan koneksi antar modul, dan memberikan lokasi sumbernya. Koneksi yang tidak dapat diselesaikan oleh REA ditandai dalam hasil.

Jika Anda ingin permanen rea perintah di shell Anda:

Instal CLI
npm install --global rea-agents

Lanjutkan dengan panduan aplikasi JavaScript

Terminal
npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json

Ganti main dengan nama atau alamat fungsi dari daftar fungsi target. Ghidra harus dikonfigurasi terlebih dahulu.

Di macOS atau Linux, kamu juga bisa menggunakan penginstal curl setelah menyiapkan Node.js:

macOS / Linux
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash

Ikuti petunjuk penyiapan untuk menghubungkan agenmu. Jika petunjuknya tidak muncul, jalankan rea setup.

Jika shell tidak menemukan rea, gunakan jalur file eksekusi yang ditampilkan installer. Di Linux, perintah penyiapan default adalah "$HOME/.local/bin/rea" setup.

Mendapatkan bantuan

Jika agen Anda tidak melihat REA

Mulai ulang atau sambungkan kembali klien setelah pengaturan. Periksa koneksi REA-nya dengan doctor; untuk Codex :

Gunakan pemeriksaan aplikasi pada langkah 3 dengan ID penyiapanmu. Dalam editor, aktifkan REA di pengaturan MCP dan izinkan alatnya dalam percakapan agen.

Jika penyedia membutuhkan perhatian

Periksa penyedia yang Anda gunakan. Untuk Ghidra :

Periksa satu penyedia
npx -y rea-agents@latest doctor --provider ghidra --json

Laporan tersebut memberikan pemeriksaan yang gagal dan langkah berikutnya yang disarankan.

Windows, WSL, dan jalur yang mengandung spasi

Gunakan Windows PowerShell untuk aplikasi dan alat analisis Windows. Jika agenmu berjalan di WSL, instal Node.js dan REA di lingkungan Linux itu dan gunakan jalur Linux di sana. Penyedia tanpa antarmuka grafis berjalan pada host yang sama dengan REA.

Di terminal, beri tanda kutip di sekitar jalur yang berisi spasi.

Perintah penyiapan Windows:

Windows PowerShell
npx.cmd rea-agents@latest setup
Perbarui atau hapus REA

Untuk memperbarui koneksi agen, jalankan kembali perintah penyiapan versi terbaru, tinjau rencananya, lalu mulai ulang aplikasimu.

Terminal
npx rea-agents@latest setup

Jika kamu menginstal CLI global, perbarui dengan rea update. Gunakan npx rea-agents@latest uninstall untuk menghapus konfigurasi aplikasi dan skill REA.

Detail pembaruan dan penghapusan

Atas