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:
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)
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:
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?
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.
curl -fsSL https://fnm.vercel.app/install | bash
Tutup terminal, buka kembali, lalu:
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:
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:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Setelah instalasi, buka kembali terminal dan masuk ke folder kerja. Lalu mulai Codex:
codex
Pilih “Sign in with ChatGPT”, selesaikan proses masuk di browser, lalu kembali ke terminal. Saat kotak pesan muncul, lanjutkan ke langkah 3.
Cursor, Windsurf, atau VS Code · gunakan editor
- Instal editor untuk sistem operasimu dan masuk ke akun.
- Buka folder rea-work yang kamu buat pada langkah 1.
- 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:
irm https://claude.ai/install.ps1 | iex
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.
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:
npx rea-agents@latest setup --client claude_desktop
Tinjau dan setujui rencana, buka kembali Claude, lalu periksa koneksi pada langkah 3.
OpenCode · pilih model AI
npm install --global opencode-ai
Jalankan opencode di folder kerja. Gunakan /connect dalam percakapannya untuk menghubungkan akun modelmu, lalu pilih 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:
npx -y rea-agents@6.4.0 mcp
3. Hubungkan REA
Tempel prompt ini ke agen pemrograman Anda:
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
npx rea-agents@latest setup
Untuk satu aplikasi tertentu, tambahkan ID penyiapannya:
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.
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 .
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:exportpesan. Proses utama memformat catatan sebagai CSV dan menulisnotes.csvdi folder Unduhan pengguna. Kolomnya adalahiddantitle.
Uji sebuah prediksi dalam latihan terpandu →
Unduh sendiri contoh ini atau gunakan aplikasimu
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.
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.
Ghidra · instal alat analisis gratis dan Java
- Instal JDK 64-bit versi 21 atau lebih baru, termasuk kompiler Java. Pilih paket yang sesuai dengan arsitektur komputermu.
-
Unduh Ghidra 12.1.4 dari daftar Assets pada rilis dan ekstrak arsip
ghidra_…_PUBLIC_….zip. Pilih arsip rilis, bukan “Source code”. -
Cari folder hasil ekstraksi yang berisi
ghidraRunataughidraRun.bat. Gunakan folder itu untukGHIDRA_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:
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:
$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
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:
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:
{
"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.
$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
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.
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:
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:
npm install --global rea-agents
Lanjutkan dengan panduan aplikasi JavaScript
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:
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 :
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:
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.
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.
- FAQ REAJawaban cepat tentang pembaruan, agen, dan analisis.
- Pilih panduan investigasiContoh yang berfungsi untuk biner, aplikasi Electron, dan browser.
- Masalah GitHubLaporkan masalah dengan perintah dan diagnostik.
- Komunitas REAPertanyaan, investigasi, dan pekerjaan yang sedang berjalan.
